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SOFTWARE DEVELOPMENT PROTOCOLS— THE MAX; MACHINE 

Following is a list of "software protocols" — standards you 
should use when programming cartridge-based software for -the , : 

Commodore VIC 20. These protocols . standardize copyright notice ,• 
use of function keys, keyboard controls and special'options. 


1 . OPENING DISPLAY 

The opening display should include the copyright notice (see. 
Number 2) and a program title. If it is. known in advance-that a 
program will be sold under different names in different countries^ 
the name of the program may be excluded, but copyright notice.must 
a ppear. The program should AUTOSTART and launch IMMEDIATELY INTO 
the PROGRAM, with the copyright notice shown in - the upper lefthand 
corner briefly, then disappearing as' the game begins'.' 


2> COPYRIGHT NOTICE 

T he proper copyright notice, which must appear 'in the opening 
display of all programs, is: 

(c) 1982 Commodore Electronics Ltd. 

T f program memory space is tight, the following alternatives may 

be used: 

( c ) 1982 Commodore Elec. Ltd 
(c) 1982 Commodore 


, cartridge games should run 
1 ca , first powered up.. : 

bridge program are: 


automatically (AUTOSTART) when 
The protocols for STARTING a 


M THE KEYBOARD... use the fl functioh key. 
ROM THE JOYSTICK. .. use' the fire button. 

!y nM THE PADDLE.use the fire button (and 

FROM check POT value). 


the 










Cartridges which use either joystick or keyboard should start from 
the fire button, and restart between rounds the same way. 
Keyboard-only programs should use the fl key to start or restart. 
Some programs may require the use of the fl key to start the 
program initially, with the fire button used to restart the game 
between rounds. 


Paddles an g'.&'a ^ fc-ie&s . -- YQtt-.ir-ec t-^stiRg-vrfrpr a paddle to start a 
game, you should also test~~the POT VALUE Lu see if there is a 
paddle be'lrig ^Ctsed : r:.(.not -j-ust^thte-^piushbut.^on^ . otherwise the program 
might th£n£ ?6a' reHsiLarting :.wi'th,;ajoystic,^/. ir since the paddle c -- • 
pushbfrt: : 4oh^iS"'-the.'.;.same^as.i':"3:,Qyst4cfe J .i§f't".. c ' - i'f the POT value is - vc - 
not 255 thSh..cy<gu ha-vefrftcpftdclle^present , 

C S 

4. USE OF GAME CONTROLS/PRIORITIES 

If your prograra/.game-itases ,a. SINGLE ;> J0YST1CK <^r includes a ONE 
PLAYER-QPTIGNaeal ling for'-a single joystick, jthe program should 
loofc'-'td--X;ame Control . Port A~. first-.and- use" f.}iat port for 1 player : 

pr6gr-ams--;.~':r:;-. .tout .. :~*r: .-r ~ et**\ao- •' 

MAX• jfO.ysfe-ick.-:i&:cis~on- the -righthand of the. keyboard and should be ' : - 
used for single .pstaatsat Rgpgraps. 1. - y 

On the Commodore-64 there are 2 joystick ports on the right side 
of the computer. Joystick A is the port closest to the back of 

the macltfCftWuerao -erfc rr.l tisaagi- . r-enf, 

5. SELF-ADJUSTING SCREEN * r 

The "self adjusting" feature of the' MAX MACHINE should 
automatically center the...picture on te screen before the orogram 
begins. This centering occurs automatically in the max. 

6. GAMES/HIGH SCORE ttzzJ . oeJ,? 

All games should record the previous "high score" for that game 
and display it either r °^ S ;, ° r ln r the corner of the 

screen while the game is being played. 


,_ M . . ‘ ----- r .ii. 

7. GAME " REWARDS" - ' - .x>... :: 

As a general standard, computer games should include several 
levels of difficulty ifedsual-ter.se »*,:9ania. progresses) and one or 

more "reward" rounds whichtma^ ttahe^tje^orm of a musical or 


'reward" rounds -a musical or 

visual display or a game action or 
higher rounds for reaching..a .higher .-score, new graphic character- 
introduced at higher levels, etc. Many games have special ^ 

"hidden" rewards at higher rounds which prompt the user to pi av 
the game over and over again to gam expertise to reach 
rounds. 


— w ^ . 

to reach thos< 











SOFTWARE DEVELOPMENT - PROTOCOLSTHE MAX MACHINE r,y 

Following is a list of " software 'protocols " -standards -you,;. "« 
should use when programming cartridge-based software for the 

Commodore VIC 20. These protocols-standardize copyright. _noti-ge. / . r l 
use of function keys, keyboard-controls-And special options. d:.:.-. r 


•L __ OPENING DISPLAY 


si* . 9. an sw ■ o 






HSU 


The opening display should" include-the copyright--notice : .(see 
Number 2) and a program title? If - it is known in .advance thatc;a.'. t> 
program will be sold under different names in different countries, 
the name of the program may be excluded, but copyright notice must 
appear. The program should AUTOSTART and launch IMMEDIATELY INTO 
THE PROGRAM, with the copyright notice shown in the upper..lefthand 
corner briefly, then disappearing as the game begins... .... 'p 


rOPYRIGHT NOTICE 


C V tO'j v :J 




• \r: •;w. 


* ■ * .i.* C£”;0 rfrh — 

Tll e proper copyright notice, which must appear in the opening-,::.-" . 
display of all programs, is: . .. 

(c) 1982 Commodore Electronics Ltd. 


a \ J/V. 


If program memory space is : tight, the following alternatives may 

be used: Vj 1 - u -' 


(c) 1982 Commodore Elec. 
(c) 1982 Commodore 


p arting the program 


Ail cartridge games should 
computet is fitst powered 
cartridge program are: 


run 
up. 


Ltd 



automatically (AUTOSTART) when the 
The protocols for STARTING a 3.^. • 


from THE keyboard. . . u g- e ,- the fl function-.key. 

FROM THE JOYSTICK. . . u¥e i the fire button. 

FROM THE PADDLE. the fire button-(and 

check POT value). 









Cartridges which use either joystick or keyboard should start from 
the fire button, and restart between rounds the same way. 
Keyboard-only programs should use the fl key to start or restart. 
Some programs may require the use of the fl key to start the 
program initially, with the fire button used to restart the game 
between rounds. 

•v 

Paddles and Joysticks... If you're testing for a paddle to start a 
game, you should also test the POT VALUE to see if there is a 
paddle being used (not just the pushbutton), otherwise the program 
might think you're starting with a joystick, since the paddle 
pushbutton is the same as "joystick left". if the POT value is 
not 255 then you have a paddle present. 

4. USE OF GAME CONTROLS/PRIORITIES 


If your program/game uses a SINGLE JOYSTICK or includes a ONE 
PLAYER OPTION calling for a single joystick, the program should 
look to Game Control Portl'A firsthand use that port for 1 player 
programs. ^ * 

MAX joystick A i@ z on. the-righthand 'o£:-.th«3'^eyboard and should be 
used for single player programs. 

On the Commodore-64 there are 2 joystick ports on the riaht side 
of the computer. Joystick A is the port closest to 2 ac v of 

the machine. L “ e u 

5. SELF-ADJUSTING SCREEN 


The "self adjusting" feature of the MAX MACHINE <=>, , , 
automatically center the picture on te screen Uld „ aIll 

begins. This centering occurs 'automatically in th^MAX 6 P rog 

6. GAMES/HIGH SCORE 


All games should record the previous "high sco 
and display it either between rounds, or in the 
screen while the game is being played. 


for that game 

corner of the 


7. GAME "REWARDS" 


As a general standard, computer games should i i 

levels of difficulty (usually as the game Dro nclude several 
more "reward" rounds which may take the form SreSSes) and ° 
visual display or a "bonus" round with specia? f a musical °^ r 
higher rounds for reaching a higher score, n * game actl ° n r acters 
introduced at higher levels, etc. Many g am@ , graphic cha 
"hidden" rewards at higher rounds which prom™- haVe s P eC1 fo play 
the game over and over again to gain expertig the those ' 
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i.'OO'jC o'll WO I Id Sf-r £‘2 is 


tele s‘tsgolsvs:: 


1. 

2 . 


CiftK’/ s~bsv 2CXI srir Ktroo? 

U2H. spbs-; ECCYssbsoI Viuribs sc: scoot 
xKLl") reidnsasr ocosr. 

SGXZ) C0b n '< :.- tsbstd 
tOBBXc EYE/ 008.>? era isbfr, 1 
(.BcISf- EYE) 9-;: i os Yictnse.&i ac2 cchibs 
LOAD "BOO^IStL*5rB±!32a.- 30 : «»n95fsgejoa. /- 

U.££Ec EYE ; i|S4.’ e ?i tor/loade r/DOS wedge 
RUN r^rrr z.\rz\ nr.^cto ~~ r«^.- . -^r- nr 


(33YET EYE; 0C0B? se aedino* mailer Of 
;£2i?l eye: 00 CD? r= uosindc mricr Of 

3. GET "CBM64 .SRC" ?■ C-^,«jSa.dPiti°% 


4. 


^ source program 


/ — w W.V 4 il* 

- - - t ; .* *«rf. r ” ’ -C 'pj ' “ or * ’ 

- : - 3: £ - c:ii '~ lv VeditP-yeek source program 


4 assembler 



.-?=»: 3&'. r.olrig- 


Note: if you wish to assemble your source code with™,*. „*ina an 

object file, do not enter a file name Wbenjthe assenM ^"r^DtsVu 
for object file name. .pcr.cro^q nsaw asz: assembler prompts you 
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.00802 r;*£ 1080 
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COMtDEORE 64 ASSEMBLER SYSTEM 


The ODM-DEORE 64 assembler system is an update of the CBM 8032 versison*. 
With the macro assembler and associated support programs, the user can now 
develop 6510 machine machine - coaej directly 3 QJK the QDMMDDORE 64. The 
assembler requires the 1541 disk drive and optionally a 1525 printer. 


Included on the CDMtDDORE 64 developer's disk are the following programs: 


EOS BOOT 

BOOT ALL 

ASM.C64 

IOIOAD.C64 

HIIOAD.C64 

EDIT.C64 

XREF.C64 

EOS 5.1 

XVM4.8 

XVM4.C 

QJM64EOS.SRC 

CBM64 TO EET 

BYEEYE 


boots the EOS wedge (RUN) 

boots the editor/leader/EOS wedge (RUN) 

macro assembler (RUN) 

loader at $0800 (RUN) 

loader at $C800 (SYS 51200) 

editor for assembly source (SYS 49152) 

.cragsreference for assembler ^JUN^oOc" C A O ‘ 
EOS'manager (SYS 52224) 

40 column monitor at $8000 (SYS 32768) KUK 
40 column monitor at $C000 (SYS 49152) 

.source, code to EOS manager 5 M'K 2 , id MSI" C3L 

short form PET emulator 

screen blank and restore routine• 


- * Q < v c, g.; • YX 'Z. D . j , ■. • 

The following list shows the 'differences between old versions of the 
assembler system and .the-.yersien -for the- COMMODORE ‘64> e ml - *' cA 

Assembler T ..- 


1. Centronics print option has been removed. 

2. The screen is not cleared when the assembler is run. 

3. Cannot run xref and object at the same time due to restrictions in the 

1541 . ->00 2 -- - -*** ' : «. 

4. This assembler has' macros. . 

5 . The screen is blanked when printing. 


Loaders 

1. Loaders print start address and end address of the load. It also nrin+-<= 
"."on each record. ^ 1X11:3 

2 Loaders reside at $0801 and $C800. 

3 * Editor and loader can be co-resident. 


Editor 

1 The cold and the break commands have been removed. 

2 This version does not scroll, (soon!) 


* note: a 
can 0 


copy of the CBM 8032 Assembler Development Packaqe , 
btained by contacting Stephen Murri at (215) 687-98 qq 
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Chapt er_1 

INTRODUCTION - 

This manual describes the Assembly Language and assembly proCe-s : s'- 
£or programs for the MCS-650X series of microprocessors. 
Several assemblers are available for program d-e^elopme’nt, and 
while they are all slightly different in detail Of'-tf&ev ’they are 

the same in substance. bs . 

r-.or. 1 ds>sc:. ' 

The process of translating a mnemonic o£' ? •'symbolTd '-' form of a 
computer program to actual machine code is called assembly, and 
a program which performs the transl d tio n is an assembler. - The' 
symbols used and rules of association for those symbols are the 
Assembly Language. In general, one" Assembly Language statement'- 
will translate into one machine instruction. 5 -Thi sP-dTsfCi-nguishes 
an assembler from a compiler which may producerria-ny - machine 
instructions from a single statement. p An ^as-s e mb-1 e"r which 

executes on a computer other than theone ^ for' •Vh’ich code is 

... /?'. - r -■ - asS€ 

non 

_ _ needed 

for an assembler. However, in the c^se of--the Commodore system 
this is not true. With a floppy disk Snd printe'r the system is 
well suited for software development. — 

7. v • ** •*;' ‘f* Xc ' > . 

Normally digital computers use the binary number system for 
representation of data and instructions. - Computers understand 
only ones and zeroes corresponding to r an ""bn •*" "br "off" state. 
I- nn i-hp nt-Ko. tnuUWorrk w 


hexadecimal (Dase 16). Two representations or cue pu 
operation to "load" informat ion i-rtto an '"accumulator" are 


10101001 ' 6 (binary) 

A9 (hexadecimal) 


An instr 
is: 


L ^ r 

uction to move the value 21 (decimal) to the accumulator 


A9 15 ^(hexadecimal) 


Users st 
to wor 

represen 

be writt 


ill find numeric representatidrts of instructions tedious 
k with, and hence , ha ve w - i,r ‘developed symbolic 


ta tions. 
en as : 


F °r example, the preceding instruction might 


this case, LDA 
suiter program u 
eC ic form A9 is 
erred to as sou 
e , only object 

h machine instr 
erred to as an 

3 re accumulato 

umulator to ind 
cessocs are 


LDA #21 ¥»«•■' 

r* t : i m J c ! br .* 

ls the symbol for A9, Load-the Accumulator. a 

Se d to translate the ''symbolic orm LDA to 

Ca 1 led an assembler . The 'symbolic prog ram is 
rce code and the numeric-program 1S the object 
c °de can be executed on the processor. 

r ~ ~ onsqq 

nction to be executed has a symbolic name 

ope ration code (OPCODE). The 0p C0DEb>§or 
c STA. The OPCODE for "transfer 

ex X° us TAX. The 56 OPCODES £° r MCS4-650X 

ailed in Chapter 2. A machine instruction in 


1 






A 3 s-e-mb 1 y Language consists of an OPCODE and perhaps OPERANDS, 

-—~Vn i'xfh specify the data on which the operation is to be 
pe r formed. 

Instructions- .may .be labelled for reference by other instructions 
as shown in: . • r , : • 

L2. . LDA i 12 

C ' - C. ^ •. • r 

The label is L2, the OPCODE 'is LDA, and the OPERAND is 112. At 
^ least., one. blank must separate .the three parts (fields) of the 
instruction. - Additional ,blanks are inserted by the assembler 
for ease of. reading. ' instructions tor the MCS-650X processors 
have ajr-most one OPERAND and many have none. in these cases the 
operation to be performed is totally specified by the OPCODE as 
.. ,M ; in CLC-CCl-ea.r the Carry Bit). 

-Programming ..-inAssembly Language requires learning the 
" "instruction set (OPCODES), .. addressing conventions £° r 
referencing data, the data structures within the processor, aS 
well -as -the. structure of Assembly Language programs. The user 
will be aided in this by reading and studying the MCS-650X 
f. . hardware And programming manuals supplied with this development 
. . - packag^e. , ■ 


213.10c IbI.: a 

sri: 2 c ync ed 
, S »A . s - i . a 
•j e lames as s;: 


o.. snc flu j j Jo or, iiz . ... 
on "Eli j ?ce! A . nc 1 s t c z > .. 
.•fosisno sipnis s-rio ic 

y<2 bs»6i c-'i sieiOi-isrir f.?•:o: 
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INSTRUCTION FORMAT 



'" Cfhapher 2 


Assembler instructions for the MCS-650X assembler are ot two 
basic types according to function: • ' ' ' '"-' c 


Machine instructions, and 
Assembler directives 


Machine instructions correspond to the 56' Operation's implemented 

on the MCS-650X processors. The instruction format* iS: 3:?: 

' ’ ; ' • . * *:■ ' jo i.c 


(label) (OPCODE)' (OPERAND) (comments") 5 ' iV 

' • ‘ •• : no. :• c :?c o 


Fields are bracketed to 
and comments are always 
(Return from Subroutine 
instruction showing all 


indicate that they are opcionaT.-' "Labels 
optional and many OPCODES such as RTS 
do not require OPERANDS. ~ I!T,1 A' "-^typical 
four fields is: no •. f ru-: * £ : 

i on i on $ j 1 2 6 } 


LOOP LDA BETA,X FETCH BETA INDEXED BY X-' 

•'•hi c eC i j i * 

A field is defined as a string of characters se ; paT:a'Ced by a 
blank space or tab characters. The list of OPCODES tdr•• the 
MCS-650X processors is shown in Table 1. 


A label is an alphanumeric string of from one to six characters, 
the first of which must be alpha. A label may not be any of the 
56 OPCODES, nor any of the special single characters, i.e. A, S, 
p f X or Y. These special characters are used by the assembler 
to reference the: 


• Accumulator (A) 

. Stack pointer (S) 

Processor status (P) 

Index registers (X and Y) 

p. label may begin in any column provided it is the first field 
rof an i ns t ruct i° n • Labels are used on instructions as branch 
targets and on data elements for reference in OPERANDS. 
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Table 1. MCS-65QX Microprocessor Instruction Set - OPCODES 


r.t, : ADC; -Add: .with :Garry to-. Accumulator JSR • ; Jump to New Location Saving 

noi 5 s eAND. <j"ANDj' tO-.;Accumulator c ?.r . • Return Address 

(r.i /:ASL iShvf.t Leffc&je ;B.i.t .{Memory ,or ; - LDA Transfer tenory to Accumulator 

F 3 c p.r.cc Accumulator) m.i: rsj \;J t.r.s=u -LDX Transfer ternary to Index X 

» - - -BOCtcBranch :0n .Care-y Clear- £ 2 r r :; m LDY Transfer temory to Index Y 

& = * erflCS. .Branch on Carry. Set.-/. LSR Shift One Bit Right (temory or 

. eseaf-BBQ) f. Branch .'On. Zero Result.. -.2 Accumulator) 

2 c 2 £ : c BIT Test Bits, in-temory with £ 


r 


zr. o & :/• -c Accumulatoro>; . : .• r.i ,n: j e.~. .NOP 

BMI Branch ort Result-Minus bn£ *--. ; ORA 
BNE Branch on Result not Zero EHA 

• j B.PJj. Branch.-o.rf Result: Plus • v;^ c ;• FHP 
' . bsse-BRK • :Fbrce an Interrupt ore Break . . PLA 

no. oo-BVCs^Branch ron Overflow Clear c .. ~>c PLP 

snoieoutdani an- ni> . : j t b a - ■ 


Nothing - No Operation 
OR" Memory with Accumulator 
Push Accumulator on Stack 
Push Processor Status on Stack 
Pull Accumulator from Stack 
Pull Processor Status from 
Stack 


2 A BVS' lBranch :on Overflow SetT c.: 
r- a. CLCr -Clear- "Carry Flag 

CUD Clear Decimal Mode 

age jciCLI 'Clear--Interrupt Disable Bit 
oi io :: CIA/ Clear Overflow Flag 
t . ' CMP- :Compare temory and ■ Accumulator 

£.. :S ;| e •-JiC.-: 1 ;- 

Lr.e CPX: Compare temory and Index X 
CPY Compare temory and Index Y 
D0C Decrement temory by One 
DEX Decrement Index? X-by. One . Y. 
DEY -Decrement ‘Index Y.by One :£j; - 
— EXDR Exclusive-or Memory with 
i n2 i v Accumulator van & s v it-r . j b 
INC Increment Memory by One 
INX Increment X by One 
i_c£ ' : INY Increment Y by One 
-irl- JMP Jump to new location 

TXS Transfer Index X to Stack 
Register 


ROL Rotate Cne Bit Left (temory or 

Accumulator) 

ROR Rotate Cne Bit Right (Memory or 
Accumulator) 

RTI Return From Interrupt 
RTS Returr From Subroutine 
33C Subtract Memory and Carry from 
Accumulator 


bet. Decimal Mode 


bhlJ __ 

otJ Interru Pt Disable Status 

STX stnll in Memory 


' f r. 


TAX 

TAY 

TSX 

TXA 

TYA 


Transfer 

Transfer 

Transfer 

Transfer 

Transfer 


Accumulator to Index X 
Accumulator to Index Y 
Stack to Index X 
Index X to ^ccunijlator 
Index Y to ^cunul^tor 


1 
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The OPERAND portion'-- of an ins traction' spec i f i es< •• e i-t'He r an 
address or a value. An address may be- computed by' expression 
evaluation and the assembler allows considerable flexibility in 
expression formation. An Assembly Language expression consists 
of a string of names and constants separated-'-by operators£+, -, 
*, and / (add, subtract, multiply, and divide). Expressions are 
evaluated by the assembler -to computer ;t-OPERAND ~ addresses. 
Expressions are evaluated left to right with -no operator 
precedence and no parenthetical grouping. Note that expressions 
are evaluated at assembly time and not execution time’,? 

;v. . ;• r. uP ' o 

Any string of characters following the OPERAND '-Afield is 
considered a comment and is listed, but not further oprocessed. 
If the first non-blank character of any record is :ai semi-colon 
(;), the record is processed as a comment. On the instructions 
which require no OPERAND, comments may follow.', the-:- OPCODE. At 
lease one separating character (space or horizontal Ota by. must 
separate the fields of an instruction. ... T - .~ c i'. 'UL' 

There are twelve assembler directives used to reserve --.s.torage 
and direct information to the assembler. Eleven have symbolic 
names with a period as the first character. The; :'.tw61 th, a 
symbolic equate, uses an equals sign (=) to establish a value 
for a symbol. a list of the directives are g iv.en i 'below and 


their use 

is explained in a later 

section . 






Y*^ 

. IFE 

•BYTE .WORD .DBYTE 

.PAGE v 

..SKIP 

>'3C 

. IFN 

.OPT .END T: .FILE 

-V. 1 . .LIB >;yc> 

= or r i **;;= 



?;*ic '' ’ c 

n■ i- •icmsP 

1C — LQt;. 

HCXi 


Labels and symbols other than directives may note J. begin with a 
period. . " *••• ~<- b lu: 

... y - • * • ' ?n«r <•: v ; ? X 

A typical MCS-650X assembler program segment is shown in/ Table 
2. This table is presented primarily to show -the form of the 
information output by the assembler. 
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Table 2 



SEGMENT OF AN MCS-650X PROGRAM 


PET LOADER.PAGE 000 2 


LINE# LOC CODE LINE 


0038 0293 
0039 0293 
0040 0293 
0041 0400 00 
;10 SYS 
0041 0401 0D 
0041 0402 04 
0041 0403 0A 
0041 0404 00 
0041 0405 9E 
0042 0406 28 31 
0042 040C 00 
0042 040D 00 
0042 040E 00 


;LINE OF BASIC TEXT TO ALLOW 
;USER TO TYPE 'RUN' 

* =$400 

•BYT 0,13,4,10,0,158 


.BYT ' (1039) ' ,0,0,0 




0044 

0045 

0046 

0047 

0048 

0049 

0050 

0051 

0052 

0053 

0054 

0055 

0056 

0057 

0058 

0059 

0060 

0061 

0062 

0063 

0064 

0065 

0066 

0067 

0068 

0069 

0070 

0071 

0072 

0073 

0074 

0075 

0076 

0077 

0078 

0079 

0080 


040F 

0411 

0414 

0417 

041A 

0 4 ID 

0 4 IF 

0422 

0424 

0427 

0 4 2A 

0 4 2C 

0 4 2F 

0431 

0433 

0435 

0437 

0439 

043C 

0 4 3E 

0441 

0443 

0445 

0447 

0449 

044C 

0 4 4E 

0450 

0453 

0454 

0457 

045A 

045C 

04 5F 

0 4 60 

0462 

0 4 6 5 


A9 

8 D 

8 D 

8 D 

8 D 

A2 

20 

A2 

8 E 

CE 

F0 

20 

C9 

F0 

C9 

FO 

A2 

8 E 

FO 

20 

C9 

FO 

C9 

FO 

AE 

EO 

FO 

9D 

E8 

8 E 

4C 

A9 

9D 

£8 

A9 

9D 

E8 


00 

81 02 
92 02 
7D 02 
7E 02 
40 

4C 05 
28 

7F 02 
7F 02 
E3 

El FI 
20 
F 4 
OD. 

D8 

00 

92 02 
07 

El FI 
20 
15 
OD 
11 

92 02 

OE 

BF 

82 02 


02 

04 


92 
3E 
2C 

82 02 


53 

82 


02 


LOAD 

LDA 

#0 


STA 

CHAN 


STA 

OBJLEN 


STA 

RECCNT 


STA 

RECCNT+1 


LDX 

#OBJMSG-MSGS 


JSR 

MSG 


LDX 

#40 


STX 

INDEX 

LD10 

DEC 

INDEX 


BEQ 

LOAD 


JSR 

BASIN 


CMP 

#$20 


BEQ 

LD10 


CMP 

#$D 


BEQ 

LOAD 


LDX 

#0 


STX 

OBJLEN 


BEQ 

LD30 

LD20 

JSR 

BASIN 


CMP 

#$20 


BEQ 

LD40 

LD30 

CMP 

#$D 


BEQ 

LD40 


LDX 

OBJLEN 


CPX 

#14 


BEQ 

load 


STA 

INX 

OBJFIL,X 


STX 

OBJLEN 


JMP 

LD20 

LD40 

LDA 

# ' , 


STA 

INX 

OBJFIL,X 


LDA 

# 'S 


STA 

INX 

OBJFIL,X 
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SYMBOLIC 


Perhaps the most common OPERAND addressing mode is the symbolic 
form as in: 

LDA BETA PUT BETA VALUE IN ACCUMULATOR 

In the example BETA references a byte in memory that is to be 
loaded into the accumulator. BETA is an address at which the 
value is located. Similarly, in the instruction 

LDA ALPHA+BETA 


-- the address ALPHA + BETA is computed by the assembler and the 
value at the computed address is loaded into the accumulator. 

Memory associated with the MCS-650X processors is segmented into 
pages of 256 bytes each. The first page, page zero, is treated 
1 . differently by the assembler and by the processor for 
optimization of memory storage space. Many of the instructions 
-have alternate operation codes if the OPERAND address is in page 
zero memory. In those cases the address requires only one byte 
rather than the normal two. For example, if BETA is located at 
the byte 4B in page zero memory, then the code generated for 

LDA BETA 


- is A5 B4. This is called page zero addressing. if BETA is at 
n-01 3C in memory page one the code generated is AD 3c 10. This 
an-example of absolute addressing. Thus, to opt imize * s tor age 
3-arid execution time, a programmer should design with data areas 
■^'in page zero memory whenever possible. Note that the assembler 
s makes decisions on which form to use based on OPERAND address 
computation. 

CONSTANTS 

Constant values in Assembly Language can take several forms. if 
a constant is other than decimal a prefix character is used to 
specify type. 


$ 

@ 

% 


The absence 
statement 

LDA 


(Dollar sign) specifies hexadecimal 
(Commercial at) specifies octal 
(Percent) specifies binary 
(Apostrophe) specifies an ASCII literal 
character in immediate instructions 

of a prefix symbol indicates decimal value. 


BETA+5 


In the 


the decimal number 5 is added to BETA to compute the address. 
gimil ar ly; 


LDA BETA+55F 


(jeriot'es that the hexacecimal value 5F is to be added to BETA f 0r 
the address computation. 

Ths immediate mode of addressing is signified by a I (a pounds 
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sign on some pcinters) followed by a constant. 

Example: LDA ¥2 

specifies that the decimal value 2 is to be put into the 
accumulator. Similarly; 

LDA f'G 

will load the ASCII character G into the accumulator. 

Immediate mode addressing always generates two bytes of machine 
code, the OPCODE and the value to be used as OPERAND. Note that 
constant values can be used in address expressions and as values 
in immediate mode addressing. They can also be used to 

initialize locations as explained in a later section on 
assembler directives. : , 

RELATIVE 

There are 8 conditional branch instructions available to the 
user. 

Example: BEQ START IF EQUAL BRANCH TO START 

which might typically follow a compare instruction. If the 
values compared are equal a transfer to the instruction labelled 
START is made. The branch address is a one byte positive or 

negative offset which is added to the program counter during 
execution. At the time the addition is made the program counter 
is pointing to the next instruction beyond the , branch 

instruction. Thus, a branch address must be within 127 bytes 

forward or 128 bytes backward from the conditional branch target 
instruction. An error will be flagged at assembly time if a 

branch target falls outside the bounds for relative addressing. 

Relative addressing is not used for any other instructions. 


IMPLIED 


Twenty-five instructions such as TAX (Transfer Accumulator to 
Index X) require no OPERAND and hence are single byte 
instructions. Thus, the OPERAND addresses are implied by the 

operation code. 


Four 

accumulator, 

case, these 

addressing 


instructions, ASL, 

A, can be used 
four instructions 
and only an operation 


LSR, ROL 
as 


and ROR are special in that the 
an OPERAND. In this special 
are treated as implied mode 
code is generated. 


indirect 


In this mode 
memory which 


the OPERAND address is a location in page 
contains the address to be used as an Operand 


g xa mpl e: LDA (BETA,X) 


zero 


entheses around the OPERAND indicates indirect mode. In 
The P hove example the value in index register X i s added to 
the 3 That sum must reference a location in page zero memory. 
BETA. eC ution the high order byte of the address ig ignored, 
thus^orcing a page zero address. The two bytes starting at 
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that location in page zero memory are taken as the address of 
the OPERAND . For purposes of illustration assume the following: 

BETA is 12 
X contains 4 

Locations 0017 and 0016 are 01 and 25 
Location 0125 contains 37 

Then BETA + X is 16, the address at location 16 is 0125. the 
value at 0125 is 37, and hence, the instruction LDA (BETA,X) 
loads the value 37 into the accumulator. This form of 
addressing is shown in the following illustration. 


LDA (operand,X) 
OPERAND » 


+ X 


value 


INDIRECT TNDEXEP 

Another mode of indirect addressing uses index rpai^ „ j : <- 
illustrated by: Agister Y and is 

LDA (GAMMA) ,Y 


In this case, GAMMA references a page zero location 
address is to be found. The value in index Y i s add^ 
address to compute the actual address of the Operakj 
for example that: ND ‘ 


which an 
to that 
Suppose 


GAMMA is 38 (hexadecimal) 

Y contains 7 

Locations 0039 and 0038 are 00 and 54 
Location 005B contains 126 


Then the address at 38 is 0054 and 7 is added 
effective address 005B. The value at 005 b 
loaded into the accumulator. 


to this giving 
is 126 which 


an 

is 


In indexed indirect, the index X is added to the odpraND pr ior 
to the indirection. The indirect indexed, th direction is 
done and then the index Y is added to compute the e ffe ctive 
address. Indirect mode is always indexed ex . onl . £or a J MP 
instruction which allows an absolute indirect address as 
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exemplified by JMP (DELTA) which causes a branch to the address 
contained in locations DELTA and DELTA+1. The indexed indirect 
mode of addressing is shown in the following illustration. 


LDA (operand), V 


OPERAND 


value 



+ Y —i 



I 
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Chapter 3 


ASSEMBLER DIRECT IVES 

/ There are twelve directives used to control the assembly 
process, define values or initialize memory locations. 
Assembler directives always appear in the OPCODE field of an 
instruction and thus might be considered as assembly time 
OPCODES instead of execution time OPCODES. The directives are: 


.IFE .BYTE .WORD .LIB .DBYTE .OPT 

.IFN .PAGE .SKIP .FILE * = or = .END 

All directives which are preceded by the period may be 
abbreviated to the period and three characters if desired eg, 
.BYT. 

.BYTE is used to reserve one byte of memory and load it with a 
value. The directive may contain multiple OPERANDS which will 
store values in consecutive bytes. ASCII strings may also be 
generated by enclosing the string with quotes. 

HERE .BYTE 2 

THERE .BYTE 1, $F, @3, %101, 7 

ASCII .BYTE 'ABCDEFH' 

Note that numbers may be represented in the most convenient 
form. In general, any valid MCS650X expression which can be 
resolved to eight bits may be used in this directive. If it is 
desired to include a quote in an ASCII string, this may be done, 
by inserting two quotes in the string; 

.BYTE 'JIM' 1 S CYCLE' 


could be used to print: 

JIM'S CYCLE 

WORD is use d to reserve and 
rrCT'^alid expression, except 
th e OP£RA ND field. 


load two bytes of data at 
for ASCII strings, may be 


a time, 
used in 


here 

there 

WHERE 


•WORD 2 

-WORD 1, SFF03, @3 
•WORD HERE, THERE 


: t-he above = 

in 1 of "HERE" , 

•.HillV ui. — 


most common use Cor .WORD is to ge 
The h .- P above example labelled "WHERE" 
c ' and "THERE". Addr 

:y in the order 
, e .WORD generates the valu 
theret ' por t ion of the example 
hexadewi t his order is not desired, 
03,FF. 11 
.WORD. 

• _ exactly Hke 

.DBYTE 

.DBYTE 


nerate addresses as shown 
which stores the 16 bit 
esses in the MCS-650X are 
low-byte and high-byto 
es in this order. Th ' 
(5FF03) would be stored 
use .DBYTE rather th 


l 0 w-by te order. 
$FF03 


WORD except the bytes are sto 


red 


in 


will generate 


pp-,03. Thus, fields generated by .DBYTE 


ma Y not 
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be used as indirect addresses. 

Equal (=) is the EQUATE directive and is used to reserve memory 
—locations, reset the program counter (*) , or assign a value to a 


symbol. 



HERE 

* = * + l 

reserve one byte 

WHERE 

*=* + 2 

reserve two bytes 

*=$200 


set program counter 

NB= 8 


assign value 

MB = NB+ % 101 

assign value 


The = directive is very powerful and can be used for a wide 
variety of purposes. 

Expressions must not contain forward references or they will be 
flagged as an error. 

Example: *-C + D- E + F 

would be legal if C, D, E and F are all defined, but would be 
illegal if any of the variables were a forward reference. Note 
also that expressions are evaluated in strict left to right 
order. 

.PAGE is used to caiuse an immediate jump to top of page and may 
also be used to generate or reset the title printed at the top 
of page. 

.PAGE ’THIS IS A TITLE' 

.PAGE 

.PAGE 'NEW TITLE’ 

If a title is defined, it will be printed at the top of each 
page until it is redefined or cleared. A title may be cleared 
with: 




.PAGE 


SKI? i s used to generate blank lines in a listing. Tne 
TjTrective will not appear but its position may be found in a 
l’sting, since it is treated as a valid input "card” and the 
1 d number printed on the left side of the listing will jump by 
two when the next line is printed. 


.SKIP 

.SKIP 

.SKIP 


2 

3*2-1 


skip two blank lines 
skip five lines 
skip one line 


oowerfui directive and 

t pu“ Helds, ^stings 
aeration of oucf u 

[tings in , BYTE directives. 


is used to control the 
and expansion of ASCII 


.OPT 

.OPT 


ERRORS, LIST, MEMORY, GENERATE 
NOE, NOL, NOM, NOG 


Also valid is: 

.OPT ERR 

Default settings are 


12 







.OPT 


MEM, LIST, ERR, NOGEN 


Here are descriptions for each of the OPERANDS: 

RORS PNO ERRORS^ : 

-Used to control creation of a separate error file. The 

error file contains the source line in error and the 
error message. This facility is normally of greatest 
use to time-sharing users who have limited print 
capacity. The error file may be turned on and examined 
until all errors have been corrected. This listing file 
may then be examined. Another possibility is to run 
with: 

.OPT ERRORS, NOLISTING 

until all errors have been corrected, and then make one 
more run with: 


.OPT 


NOERRORS, LISTING 


LIST FnOLIST] : 

-- Used to control the generation of the listing file which 

contains source input, errors and warnings, code 
generation, symbol table and instruction count if 
enabled. 

MEMORY [NOMEMORYl: 

- Used to control generation of the memory file, which is 

used as an interface between the assembler and the 
simulator and various loader programs. The memory file 
contains information about symbols, line numbers and 
code generation, and is described in detail elsewhere in 
this document. 

pa TE FnOGENERATE] : 

9^ —-"used to control printing of ASCII strings in the .BYTE 

directive. The first two characters will always be 
printed, and subsequent characters will be printed 
(normally two bytes per line) , if GENERATE is used. 

hnuld be the last statement in a file and is used to 
JpiE ® n he physical end of the file. Its use is optional, but 
s ^ n f r pcommended for program documentation. 

highly symbol table will not be generated until a .END is 

NOTE : Tne 
found. 

tive allows the user to construct control files 
.lib dire this directive which inserts the module named into 
corTtaining when the assembler encounters this directive, it 

the asseI " lv ceases reading source code from the file containing 
temporarily s cea ding f rom the file named on the .Lib. 
it and . Q f the original source file resumes when end-of-f 
processing . g enC ountered in the library file. The control 
(EOF) ° r * • ; n q the -LIB can contain other assembler directi Ves 

> e contain ^ tin g function On and off etc., 
to’ turn the 

ca }led oy a lib may not contain another .lib, 
a library f 1L ' ln a .FIL. 
but j. t may con 
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.FIL terminates assembly of the file containing it and transfers 
source reading to the file named in the OPERAND. There are no 
restrictions on the number of files which may be linked by .FIL 
directives. Caution should be exercised when using this 
directive to ensure that no circular linkages are created. An 
assembler pass can only be terminated by (EOF) or .END 
directive. 


The following is an example of .LIB control and .FIL control. 
This example is extensive and it should not be taken verbatum 
but used as a source of ideas. 



.IFE / .IFN 

Conditional Assembly Directives, these allow the same source 
file to be used to generate different versions of the final 
code, for different machines. The syntax is the same for both 


.IFE expression > 

Code to be assembled 

In this case IF expression equals zero 
the > and <. The code to be assembled 
after the <IF, the <C must be the first 


assemble the code between 
must start on a new line 
symbol on a line. 


IFN 


expr 

^cion is not 

zero. 

Eg. 

MEM = 8 
COLS = 40 
* = $ 3B00 

;DEFAULT START ADDRESS 


WIDTH = 40 

IFE MEM" 8 

* = $1B00 


> 


;DEFAULT SCREEN WIDTH 


;START FOR 8K PET 
flFN COLS-40 ) 

WIDTH * 8° ;80 COLUMNS ON SCREEN 

< 


tn this example the program counter (*) WQuld fae set to S1B00 
"d width would be set at 40 (cois-40 = 0 ) 
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Chapter 4 


OUTPUT FILES 

There are three output files generated by the assembler. Each 
file is optional through the use of the .OPT assembler 
directive. The listing file contains the program list, and 
symbol table. The error file contains all error lines and 
errors. The error file is included in the listing file. The 
interface file contains the object code for the loader. 

LISTING FILE 


f 




The listing file will be produced unless the NOLIST option is 
used on the .OPT assembler directive. This file is made up of 
two sections: Program, and Symbol Table. 


Program 

This listing will always be produced unless the NOLIST option is 
selected. It contains the source statements of the program 
along with the assembled code. Errors and warnings appear after 
erroneous statements. An explanation of error codes are 
presented in part B. A count of the errors and warnings found 
during the assembly are presented at the end of the program. 

Symbol Table 

The symbol table will always be produced unless the NOSYM option 
is used. It contains a list of all symbols used in the program, 
and their addresses. 

INTERFACE FILE 

The format for the first and all succeeding records, except for 
the last record, is as follows: 


. nlnO a3a2ala0 (dldO)l (dld0)2 x3x2xlx0 
Where the following statements apply: 


All characters (n,a,d,x) are the ASCII characters 0 throuqh 
F, each representing a hexadecimal digit. 


. is a record mark indicating the start of a record. 


nlnO 


= the number of bytes of data in 
(in hexadecimal). Each pair 
characters (dldO) represents a 
the record. 


this record. 

hexadecimal 

b yte in 


single 


4 . 


fl 3 a 2 ala 0 = the hexadecimal starting address for tha 

a3 represents address bits 15 thru i2 record - 

The 8 -bit byte represented by (dldO)i ic' ? tc *‘ 

in address a3a2ala0; (dldO)2 is st J ore 
X 1 stored in 
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5. (dldO) =* two hexadecimal digits 

representing an 8-bit byte of data. (dl = 
high-order 4 binary bits and dO = low-order 
4-bits). Maximum of 18 (Hex) or 24 (decimal) 
bytes of data per record is permitted. 


6. x3x2xlx0 = record check sum. This is the hexadecimal sum 

of all characters in the record, including the 
nlnO and a3a2ala0, but excluding the record mark 
and the check sum of characters. To generate 
the check sum, each byte of data (represented by 
two ASCII characters) is treated as 8 _ binary 
bits. The binary sum of these 8-bit bytes is 
truncated to 16 binary bits (4 hexadecimal 
digits) and is then represented in the record as 
four ASCII characters (x3x2xlx0). 


The format for the last record in a file is as follows: 


1 . ; 00 

2. c3c2clc0 

3. x3x2xlx0 


; 00 c3c2clc0 x3x2x1x0 

zero bytes of data in this record. This 
identifies this as the final record in a file. 

the total number of records (in hexadecimal) in 
this file, NOT including the last record. 

check sum for this record. 
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ERROR LIST 


Error messages are given in the program listing accompanying 
statement in error. The following is a list of all error 
messages which might be produced during assembly. 


** A,X,Y,S,P RESERVED 


A label on a statement is one of the five reserved names 
(A,X,Y,S and P). They have special meaning to the assembler and 
therefore cannot be used as labels. Use of one of these names 
will cause this error message to be printed and zero bytes to be 
generated for the statement. The label does not get defined and 
will appear in the symbol table as an undefined variable. 
Reference to such a label elsewhere in the program will cause 
erroi messages to be printed as if the label were never 
declared. 

HOW TO AVOID: Don't use A, X, Y, S or P as a label to a 
statement. 


**•A MODE NOT ALLOWED 


Following a legal OPCODE, and one or more spaces, is the letter 
A followed by one or more spaces. The assembler is trying to 
use the accumulator (A = accumulator mode) as the OPERAND. 
However, the OPCODE in the statement is one which does not allow 
reference to the accumulator. Check for a statement labelled A 
(an illegal statement), which this statement is referencing. if 
you were trying to reference the accumulator, look up the valid 
OPERANDS for the OPCODE used. 


**INVALID ADDRESS 


An address referred to in an instruction, or in one of the 
assembler directives (.BYTE, .DBYTE, .WORD), is invalid. in the 
case of an instruction, the OPERAND that is generated by the 
assembler must be greater than or equal to zero, and less than 
or equal to $FFFF (2 bytes long). (This excludes relative 
branches which are limited to +/ - 127 from the next 
instruction.) if the OPERAND generates more than two bytes of 
code or is less than zero, this error message will be printed. 
For a .BYTE each OPERAND is limited to one byte, and for a .WORD 
each OPERAND is limited to two bytes. All must be greater than 
or equal to zero. 


This validity is checked after the OPERAND is evaluated, 
for values of symbols used in the OPERAND field (see the 
table for this information). 


Check 

symbol 



**forward 
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discovered, it is substituted into the table and the assembler 
processes all o£ the input statements a second time using 
currently defined values. 

A label or expression which uses a yet undefined value is 
considered to be referenced forward to the to-be-defined value. 


To allow for conformity of evaluating expressions, 
assembler allows for one level of forward reference so that 
following code is allowed. 


this 

the 


Card Sequence 
100 
200 


Label 
New One 

But the following is not allowed: 

Label 


Card Sequence 
100 
200 
300 


New One 
Next 


Opcode 

BNE 

LDA 


Opcode 

BNE 


LDA 


Operand 
New One 

*5 


Operand 
New One 
Next + 5 

*5 


This feature should not disturb the normal use of labels as the 
cure tor this error 


Card Sequence 
100 

300 

301 


Label 

Next 
New One 


Opcode 

BNE 

LDA 


Operand 
New One 

*5 

Next + 5 


cui 


is very simple and always solves the problem. 

= i c nri^ 0 ^ j"^ SO mean that the value on the right side of 

is the definei ? at a11 in fche Program; in which case, the 
is the same as for undefined values. 

The assembler cannot process more than one computed forward 
reference. All expressions with symbols that appear on the 
right side of any equal sign must refer only to previously 
defined symbols for the equate to be processed. 

* * illegal operand_type 


A£ ter finding an OPCODE that does not have an imolied OPERAND, 
the assembler passes the OPERAND field (the next non-blank field 
following the OPCODE) and determines what type of OPERAND it lS 
(indexed, absolute,,etc.). If the type of OPERAND found is n0t 
alld for the OPCODE, this error message win be printed. 

< r h ® cl < to see what types of OPERANDS are allows frtr the OPCODE 
nd make sure the form of the OPERAND typ e .• _ ed f ° r _^ /cpc the 


sec tion on addressing modes) 


is 


Check fo r the OPERAND field starting with , * 

1S Su PPosed to be an indirect OPERAND 3 v* the 

recheck tne 


to 


format f 0r the two types available. j f .. c af wa s 

(missing right paren or index register) the forma w il 

Panted. A ? so check for missing or . ^ 1S e °[ e rs i 

in exed OPERAND (form: expression, mdex^ lndex 

inuex register) 


If 

cor re 
wrc 
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“IMPROPER OPCODE 


The assembler searches a line until it finds the first non-blank 
character string. If this string is not one of the 56 OPCODES 
it assumes it is a label and places it in the symbol table. It 
then continues parsing for the next non-blank character string. 
If none are found, the next line will be read in and the 
assembly will continue. However, if a 2nd field is found it is 
assumed to be an OPCODE (since only one label is allowed per 
line). If this character string is not a valid OPCODE, the 
error message is printed. 

This error can occur if OPCODES are misspelled, in which case 
the assembler will interpret the OPCODE as a label (if no label 
appears on the card). It will then try to assemble the next 
field as the OPCODE. If there is another field, this error will 
be printed. 

Check for a misspelled OPCODE or for more than one label on a 
line. 


“CAN'T EVAL EXPRESSION 


In evaluating an expression, the assembler found a character it 
couldn't interpret as being part of a valid expression. This 
can happen if the field following an OPCODE contains special 
characters not valid within expressions (eg parentheses). Check 
the OPERAND field and make sure only valid special characters 
are within a field (between commas). 


* * INDEX MUST BE X OR Y 


After finding a valid OPCODE, the assembler looks for the 
OPERAND. In this case, the first character in the OPERAND field 
is a left paren. The assembler interprets the next field as an 
indirect address which, with the exception of the jump 
statement, must be indexed by one of the index registers, x or 
Y. in the erroneous case, the character that the assembler was 
trying to interpret as an index register was not X or Y and the 
error was printed. 

Check for the OPERAND field starting with a left paren. If i t 
is supposed to be an indirect OPERAND, recheck the correct 
format for the two types available. If the format was wrong 
(missing right paren or index register), This error will be 
nrinted. Also check for missing or wrong index registers in an 
indexed OPERAND (form: expression, index register). 

“LABEL START NEED A-7 


The fi cSt non-blank field is not a valid OPCODE. Therefore, the 
Assembler tried to interpret it as a label. However, the first 
rharacter of the field does not begin with an alphabetic 
haracter and the er ror message is printed. 


. for an unlabelled statement with only an Operand field 
c " e does start with with a special character. Also check for 
tha label instruction. 

illegal 
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**LABEL TOO LONG 


( 


Ail symbols are limited to six characters in length. When 
parsing, the assembler looks for one of the separating 
characters to find the end of a label or string. If other than 
one of these separators is used, the error message will be 
printed providing that the illegal separator causes the symbol 
to extend beyond six characters in length. Check for no spacing 
between labels and OPCODES. Also check for a comment card with 
a long first word that doesn't begin with a semicolon. In this 
case the assembler is trying to interpret part of the comment as 
a label. 


* *NON-ALPHANUMERIC 


Labels are made up of from one to six alphanumeric digits. The 
label field must be separated from the OPCODE field by one or 
more blanks. If a special character or other separator is 
between the label and the OPCODE, this error message might be 
printed. 

The 56 valid OPCODES are each three alphabetic characters. They 
must be separated from the OPERAND field (if one is necessary) 
by one or more blanks. If the OPCODE ends with a special 
character (such as a comma), this error message will be printed. 


In the case of a lone label or an OPCODE that needs no OPERAND, 
they can be followed directly by a semicolon to denote the rest 
of the card as a comment (use of a semicolon tabs the comment 
out to the next tab position). 

** DUPLICATE SYMBOL 

The first field on the card is not an OPCODE so it is 
interpreted as a label. If the current line is the first line 
in which that symbol appears as a label (or on the left side of 
an equals sign), it is put in the symbol table and tagged as 
defined in that line. However, if the symbol has appeared as a 
l.-bel, or on the left of an equate, prior to the current line, 
the assembler finds the label already in the symbol table The 
assembler does not allow redefinitions of symbols and will in 
this case, print the error message. ' 


* * INDIRECT OUT OF RANGE 


An indirect address is 
parentheses that surround 
has parens around it, the 
an indirect address. If 
(is larger than 255 - one 
pr inted. 


recognized by the = , . 

if ’ T( .. i. , ne assembler 
it. If the field 
= 11 ° following ai 

assembler will trv ut 

i.unnc-DRv.^ c . , c y to assembli 
the OPERAND field a „,. , 

hu( . ol ia extends into 

byte) r this grror 

etr °r message 


by the 
OPCODE 
it as 

absolute 

will be 


This error will only occur if the OPERAND f ield is in correct 
form (ie an index register following the address), and t * ie 
address field is out of page zero. To correct this the address 
field must refer to page zero memory. 
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*«PC NEGATI VE-RKSF.T 0 


An assembled program is loaded into core from position 0 to 64K 
(65535). This is the extent of the machine. Instructions can 
only refer to up to 2 bytes of information. Because there is 
( such a thing as negative memory, an attempt to reference a 
negative position will cause this error and the program counter 
(or pointer to the current memory location), will be reset to 0. 


When this error occurs, the assembler continues assembling the 
code with the new value of the program counter. This could 
cause multiple bytes to be assembled into the same locations. 
Therefore, care should be taken to keep the program counter 
within the proper limits. 


* *RAN OFF END OF CARD 


This error message will occur if the assembler is looking for a 
needed field and runs off the end of the card (or line image) 
before the field is found. The following should be checked for: 
a valid OPCODE field without an OPERAND field on the same card: 
an OPCODE that was thought to take an implied OPERAND, which in 
fact needed an OPERAND: an ASCII string that is missing the 
closing quote (make sure any embedded quotes are doubled - to 
have a quote in the string at the end, there must be 3 quotes 
2 for the embedded quote and one to.close off the string); a 
comma at the end of the OPERAND field indicates there are more 
OPERANDS to come: if there aren't other OPERANDS, the assembler 
will run of ^ t * ie car< 3 looking for them. 



*,* BRANCH OUT OF RANGE 


All of the branch instructions (excluding the two jumps), are 
assembled into 2 bytes of code. One byte is for the OPCODE and 
the other for the address to branch to. To allow a forward or 
backward branch, this branch is taken relative to the beginning 
of the next instruction, according to the address byte. If the 
value of the byte is 0-127 the branch is forward; if the value 
is 128-255 the branch is backward. (A negative branch is in 2's 
complement form). Therefore, a branch instruction can only 
branch forward or backward 127 bytes relative to the beginning 
of the next instruction. jf an attempt is made to branch 
further than these limits, the error message will be printed. 
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‘♦UNDEFINED DIRECTIVE 


All assembler directives begin with a period. If a period is 
( the first character in a non-blank field the assembler 

interprets the following character string as a directive. If 
the character string that follows is not a valid assembler 
directive, this error message will be printed. 

Check for a misspelled directive, or a period at the beginning 
of a field that is not a directive. 


♦♦ UNDEFINED SYMBOL 

This error is generated by the second pass. If, in the first 

pass the assembler finds a symbol in the OPERAND field (the 

field following the OPCODE or an equals sign), that has not been 
defined yet, that symbol is flagged for interpretation by pass 
two. If the symbol is defined (shows up on the left of an 
equate or as the first non-blank field in a statement), pass 
one will define it and enter it in the symbol table. Then a 
symbol in an OPERAND field before the definition will be defined 

with a value when pass two assembles it. In this case the 

assembly process can be completed. 

However, if pass one doesn't find the symbol as a label or on 
the left of an equate, it never enters it in the symbol table as 
a defined symbol. When pass two tries to interpret the OPERAND 
field this type of symbol is in, there is no value for the 
( symbol and the field cannot be interpreted. Therefore, the 

w error message is printed with no value for the OPERAND. 

This error will also occur if a saved symbol A, X, Y, S or P, is 
used as a label and referred to elsewhere in the program. On 
the statement that references the saved symbol, the assembler 
sees it as a symbol that has not been defined. 

Check for use of saved symbols, misspelled labels or missing 
labels to correct this error. 


NOTE: 

When the assembler finds an expression (whether it is in an 
OPERAND field or on the right of an equals sign) it tries to 
valuate the expression. If there is a symbol within the 
6 nress’on that hasn't been defined yet, the assembler will flag 
a forward reference and wait to evaluate it in the second 
lt fc he expression is on the right side of an equal sign, 

P K SS forward reference is a severe error and will be flagged as 
the However, if the expression is in an OPERAND field of a 
OPCODE the first pass will set aside 2 bytes for the 
va 7 n f the'expression and flag it as a forward reference. 
val .he ?nd oass fills in the value °£ the expression, and 
Mhe " of the expression is one byte long ie ) 2 56, 


the 
the 
e 

y 


Val hruction is one byte longer than required, because th 
1 nS rr\ reference to page zero memory wastes one byte of memor 
f ° r ?he extra one that was saved, because, during the first pass, 
assembler didn’t know how large the value was, so had to 


save 


for the largest value - two bytes 
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COMMODORE 64 MONITORS 


(XVM4.8 and XVM4.C) 


The Commodore 64 monitors are essentially the same as VICMON except for the 
following considerations: 

o To load the appropriate monitor enter: 

LOAD "XVM4. 8 " , 8,1 (monitor at $8000) SYS 32768 or 

LOAD "XVM4.C",8,1 . (monitor at $COOO) SYS 49152 

o There is no WALK command. • ’ 

o There is no TRACE command. 

o In order to protect page zero from destruction, you must execute 
an E (enable) command before branching tor your code with a G 
command. For example: 

Your code is constructed at C100. Before executing a G C100 
command, type e C000 (or any other safe area of memory to 
save page zero). The monitor will use the specified location as 
a temporary storage area for page 0. When a B (breakpoint) 
command is encountered in your code, the monitor will restore 
page 0. 

o After exiting f rom the mo nitor, perform a cold start by entering: 

SYS 64738 

Most programs win remain untouched. 



THE DOS WEDGE 
(DOS 5.1) 


This program is an aid to the Commodore 64 user. When the program is 
operating, the user may enter disk commands and interrogate the error 
channel without using BASIC commands. 

When the wedge program is running it is "wedged" into the operating system 
and BASIC interpreter. Thus the program can trap keyboard input before 
BASIC can see it. 


The following is a list of DOS 5.1 commands: 


>10 

>S0:S* 
>$0 


>$0:BASIC* 

>(RETURN) 

>#9 

>Q 

/ASM.C64 

tASM.C64 

%PADDLE2 

«-PADDLE2 


Initialize drive 0. . 

Scratch all files on drive 0 that start with' 
the letter "S". « 

Read the directory on drive 0 and print it to 
the screen. (This does not destroy programs in 
memory.) 

Read the directory on drive 0 and search for 
filenames starting with BASIC. 

Interrogate the error channel and print error 
message on screen. 

Change to device 9 etc. 

Exit DOS wedge. 

Load the program named "ASM.C64" (LOAD "ASM.C64" 8) 
Load then run the program named "ASM.C64. 

Load the program named "PADDLE2" without relocatino 
(LOAD "PADDLE2",8,1). ing 

Save the program named "PADDLE2". 


The following list shows differences between old versions of the DOS wedq 
and DOS 5.1: 

o % command loads without relocating, 
o Commands can be used in a program. 

o DOS 5.1 pulls filename from quotes and ignores the rest of 
line. 

o Commands do not have to start in column 1. 
o DOS 5*1 does not auto relocate, 
o Arrow left is save command, 
o >#9 changes to device 9, etc. 
o >Q exits DOS 5.1. 






A ppend ix_1 


UNIVERSAL WEDGE 


This program is an aid to the disk user. When the program is 
operating, the user may enter disk commands and interrogate the 
disk error channel without using BASIC commands. 


When the wedge program is running it 
operating system and BASIC interpreter, 
trap keyboard input before BASIC sees 
linking into the CHRGET routine in page 


is 'wedged' into 
Thus the program 
it. This is done 
zero. 


the 

can 

by 


The operation of the wedge 
commands that are typed in 
line. The greater-than 
directories, send commands 
following examples illustr 


prog ra 
the f i 
symbol 
and r 
ate the 


m is accomplished using three 


rst character 
(^>) is used 
ead the error 
usage of the 


position of a 
to print the 
channel. The 
command: 


>10 

>S1:S* 

>$1 

> $0:BASIC* 


Initialize drive 0 
Scratch all files on drive 
one that start with the letter S 
Read the directory on drive 1 
and print it to the PET screen 
Read the directory on drive 0 
and search for filenames 
starting with the string 'BASIC' 


The most notable attribute about this method of reading the 
directory is that it does not destroy programs in memory so you 
may examine the directory at any time. 

The third use of the > command is interrogation of the disk 
error channel. This is done by typing: 


)>( RETURN) 


the computer responds by printing the error message on the 
screen. This does the same thing as the following BASIC 
prog ram: 


10 OPEN 15,8,15 
20 INPUTU5 ,A,B$ ,C, D 
30 PRINTA;B$;C ; D 


HOTE : After a cold start, do not attempt to read the 
channel before sending a command. 


error 


Business keyboard users may substitute the @ (commercial at) 
symbol in Place of 


second command is the slash command. it performs the 
function a s the BA SIC 'LOAD' with a simplified format: 

/ASSEMBLER 


same 


hove command loads the program named 'ASSEMBLER' 
The same thing as the following BASIC command, 

does the 

LOAD"ASSEMBLER",8 
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The third program is the LOAD/RUN command, 
implemented using the up-arrow key ■f . 


This command is 


( tHURKLE 

This example would load then run the program HURKLE. 

The wedge program is the first program on the development 
thus it may be loaded with the LOAD"*",8. This command 
an automatic initialization on Drive 0 when executed 
first disk command after a cold start. 




v 


disk, 
causes 
as the 
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Appendix 2 


INSTRUCTIONS FOR THE MINI-EDITOR 

The MINI-EDITOR is included on the diskette supplied with this 
manual. There are two versions; EDITOR16K and EDITOR32K, used 
in 16K and 32K machines respectively. The only difference 
between the two versions is the load point. 

The editor is used to enter and modify source files for the 
assembler. The editor retains all of the features of the screen 
editor plus; automatic line numbering, find, change, delete with 
range, and renumber. Other commands include get, put, break, 
kill, and format. All of the commands are detailed in the 
summary at the end of this appendix. 

This is a line number oriented editor but with the functions of 
the screen editor it can be considered to have a character- mode 
which includes the lines appearing on the screen. The editor 
commands operate in a similar fashion to the commands already 
existing in the computer's BASIC. There are several example 
files included on the diskette with the editor. Users would be 
well advised to try out the editor on these files in order to 
familiarize themselves with the commands. 

The data files on which the assembler operates are ASCII 
characters with each line terminated by a carriage return. The 
only restriction on data files is in naming. Due to the method 
in which the assembler parses, you are not allowed spaces in 
filenames. The files are sequential and must be terminated by a 
zero byte $00. 

LOADING THE MINI-EDITOR 

---- 

The editor can be loaded with the wedge load command or with a 
BASIC load command: 

/EDITOR32K or 
L0AD"EDIT0R16K",8 


to initiate the editor use the SYS command. The editor is 
tarted with the following commands, SYS7*4096 for the 32K 
5 ersion, and SYS3M096 for the 16K editor. After typing the SYS 
ve and the editor will respond with the message 'MINI-EDITOR 
c ° 1679 '. At this point type a NEW command to clear the text 
^ i-^rc You are now ready to edit assembler source files. 

point s • 


OPERATION OF THE MINT-Pn TT OF 


When the 


MINI-EDITOR is in operation 
10 FOR 1=1 TO 10 


any 


statement 


typed : 


•n not be tokenized. Thus, you cannot type a BASIC U ne 
W1 pditor turned on. To avoid the above problem you 
disable the editor with the 'KILL' command or reset to 

clean. 


with 

must 

start 


files are loaded with the 'GET' command. As 
S° ntc the e ditor adds line numbers. The editor 
l0 bering at 1000. After editing your file, ensure 


th ® file 
s tar ts 
that 


is 

its 

the 
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Then 


save 


last line is a .FILE or a .END assembler directive, 
your file on disk with the 'PUT' command. 


( 


The repeat key is enabled by typing (return). All of the keys 
on the keyboard will repeat when held down for more than 
one-half of a second. The repeat function is still operational 
after the editor has been killed. To disable the repeat 
function type: SHIFT-RUN/STOP followed by RUN/STOP (for version 
2.0 BASIC). Type LOAD (return) followed by RUN/STOP (for 
version 4.0). 


MINI-EDITOR COMMANDS 

Auto Line Numbering 

The function of this command is to generate new line numbers for 
entry of source code. In order to enable the auto command type 
the following: 

AUTO nl (return) 

where nl is the increment between line numbers printed. To 
disable the auto function type the auto command without an 
increment. 

Break Command 

The BREAK command jumps to the ROM resident monitor. This 
command is executed by typing: 

BREAK(return) 


v 


Change String 


The change command 
replace one string 
command is entered 


allows the user to automatically locate 
with another (multiple occurrences). 
in the following format: 


and 

This 


CHANGE/str1/str 2/,nl-n2 


/ 

s t r 1 
str 2 

, nl" n 2 


Delimits the strl and str2 

(any character not i n either str) 

Search string 

Replacement string 

Range parameters. Tha - .. . 

the same as the ractp for mat is 
command. If omu^LIST 

whole file is searched 


COLD 


Resets the PET to its power on conditions. Th 

reset nor is PET memor y between $0100 and snan disk unit is not 
to clear memory to allow the HI-LOADER ,?°* Its Purpose is 
loaded. memory tR (MID-LOADER) to be 
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Delete 



A 

q 


delete 
uicker. 


range function haa been 
The format is the same as 


DELETE nl-n2 


included to make deletion 
the BASIC list command: 


Ensure that you use the range parameters, as leaving them out 
causes the entire file to be deleted. 

Find String 

The find string command is used to locate specific strings in 
text. Each occurrence of the string is printed on the CRT. You 
can halt the printing with the SPACE bar. Printing can then be 
continued with the SPACE bar or terminated with the STOP key. 
The format of the FIND command is: 

FIND/strl/,nl-n2 

/ Delimiter 

strl Search string 

,nl-n2 Range parm. same as BASIC 

list command 


Formatted Print 


The format command is used 
format like the assembler, 
you must type mnemonics in 


to print the text file in tabbed 
For this function to work correctly 
column two, or one space from labels. 


FORMAT nl-n2 
nl-n2 


Range parms of the same 
format as LIST. 


NOTE: This command has the same controls as find. For example, 
SPACE halts printing, SPACE restarts, and STOP quit. 


GET Files 

Input assembler text files from disk. This command is used to 
load source files into the editor and append to files already in 
memory. 

GET "FILE-NAME",nl,n2,n3 

n l Begins inputting source 

at this line. 

n2 Device t , default i s 8 

n 3 Secondary address 

default is 8 


NOTE: GET starts numbering at 1000 by 
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KILL Command 


This command causes the editor to disengage. This does not 
disable the repeat function if it has been turned on prior to 
KILL. To restart the editor, type the same command used to 
start the editor. 


Resequence Lines 

The NUMBER function allows the user to renumber all or part of 
the file in memory. 

NUMBER nl,n2,n3 


nl 

Old 

start 

line 

number 

n2 

New 

start 

line 

number 

n3 

Step 

size 

for 

resequence 


PUT Command 


The PUT command outputs source files to the floppy for later 
assembly. PUT has the ability to output all or part of the 
memory resident file. 

PUT "0:NAME",nl-n2,n3,n4 


0: 

Drive number, for disk only 

NAME 

Output file name 

nl 

Starting line number 

n2 

Ending line number 

n3 

Device #, default is 8 

n4 

default is 8 


If nl-n2,n3,n4 are left out, the whole file is outputted to the 
default device. 

When using the device number parameter to PUT a file the syntax 
should should be altered to 

PUT"0:NAME",nl-,n3,n4 

This is because of the way in which the editor parses the 
commands. 
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COMMAND 


MINI-ED ITOR COMMAN D SUMMARY 

DESCRIPTION 


( AUTO nl 

AUTO 

BREAK 

CHANGE/s1/s2/,nl-n2 
CHANGE/S 1/S 2/ 

COLD 

DELETE nl-n2 
FIND/sl/,nl-n2 
FIND/s1/ 

FORMAT nl-n2 
GET"FILE",nl-n2,n3 
GET"FILE" 

KILL 

LIST 

NUMBER nl,n2,n3 

PUT"0:FILE",nl-n2,n3,n4 

PUT"1:FILE" 


Starts automatic line 
numbering 
Shuts off auto 
Jump to the monitor 
Change string 
Change string no range 
Reset the PET 
Delete range 
Find string 
Find string no range 
Print formatted 
Bring in text 
Short form get 
Disable the editor 
List lines of text 
Renumber text 
Save text on disk 
Sa^e text short form 


i 
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0P ERATION OF THE PET ASSEMBLER 


Appe ndix 3 


The assembler loads as a BASIC program. To start the assembler, 
enter a RUN command. This works because the program starts with 
a SYS command which is set up in the assembler source. An 
example of how to start a program in this manner is given just 
before the appendices of this manual. When the assembler is run 
it will print a copyright notice and print the first user 
prompt. 

The first user prompt is for an object filename. if no object 
file is desired, type a return for this prompt. if an object 
file is desired the response would be something like: 

OBJECT FILE? 1:TEST0BJ 


Note that a drive number must be specified before the filename. 


The second prompt is for hard copy. A null response will 
produce output. You must type N for no, followed by a return to 
defeat the printed listing. 


The hard copy may be directed to the IEEE port (device #4) or to 
the User Port. (User Port handshake is Centronics parallel; 
see the notes at the end of this appendix for details) . The 
user determines which method by responding Y or N to the IEEE 
printer question. a null response defaults to a yes. 

The final prompt is for the source filename. When the user 
types the name of the file to be assembled followed by return, 
the assembler starts operation. If a null response is detected 
the assembler returns control to BASIC. This allows the user to 
correct mistakes. 

Upon startup the assembler initializes both of the disk drives, 
opens the source file and starts the assembly. if an object 
file has been requested it is also opened. 


There are several errors which may occur on a system level 
rather than an assembly level. These errors are caused by disk 
problems and user errors. They are generally easy to solve as 
is presented in the following examples. 


The first is 'FILE NOT FOUND'; which is produced when one of the 
following occurs: 

1. The source file was not found. 

2 . a .LfB specifies a nonexistant file. 

3. a .FIL specifies a nonexistant file. 


This error is of the human type: eg, the user 
filename or placed the wrong diskette into the 


has mis 
floppy. 


typed 


a 


The 
the 
Th is 
the 


second error is 'file EXISTS'. This 

obiect file named already exists on 

error can De cuc ed by scratching the 
diskette. 


error 

the 

old 


is Produced when 
, d . s Pecif ied. 

flle 0r changing 


. . • r h error is 'read error'. This error 
The th i ra 


is 3 disk read 
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error. Please refer to the Disk user manual for 
of the errors and their causes. 


a description 


( 




Notes on Operation 

When the assembler is running, operation may be halted by 
pressing the RUN/STOP key. This only halts the assembly 
process; operation may be terminated at this point by pressing B 
or T key. These keys return control to BASIC or TIM 
respectively. Pressing any other key continues the assembly 
process. This feature is useful for users without printers as 
the screen listing can be examined during assembly. ' 

The assembler can send the printed output to the User Port with 
a Centronics parallel handshake method. This allows the user to 
attach a printer other than a Commodore printer. The data is 
transferred byte parallel with two handshake lines Data Strobe 
and Acknowledge (both active low). The data is placed on the 
port then the Data Strobe is pulled low 6 usees later startina 
the handshake sequence. The computer now waits' for the 
acknowledge line to be pulled low by the printer. when thi<? 
happens, the data strobe line is released and the handshake 
sequence is completed for one character. The following Dresents 
the interconnection for the interface. The user should keeD 
cable lengths to a minimum, as there are no line drivers in the 
computer on the output lines. The user should also check the 
loading of the device that is being connected because the 
computer can only drive one standard TTL load. e 

Interconnect ion Table 


Description Centronics 


M 

(cb2) 

Data Strobe 

1 

C 

(paO) 

Data 1 

X 

2 

D 

(Pal) 

Da ta 2 

Cm 

2 

E 

(pa2) 

Da ta 3 

j 

4 

F 

(pa3) 

Data 4 

5 

H 

(Pa 4) 

Data 5 

6 

J 

(pa5) 

Da ta 6 

7 

K 

(pa6) 

Data 7 

8 

L 

(Pa7) 

Data 8 

9 

B 

(cal) 

Acknowledge 

10 

N 

(gnd) 

Ground 

16 

A 

(gnd) 

Ground 
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App e nd i x __4 


PET LOADERS 


The PET Assembler produces portable output in an ASCII format 
that is not directly executable. This output must be LOADED so 
the program can be executed. This is the function of a Loader. 


There are three versions of the Loader included on the 
development disk. Each version is positioned in a different 
area of RAM memory. This allows the user to load anywhere in 
RAM by using the correct loader. The following table shows the 
names, load points and run commands for each of the three 
loaders. 


NAME 

LOADER 

MID-LOADER 

HI-LOADER 


LOAD ADDRESS 
$0400 
$3000 
$7000 


RUN COMMAND 
RUN 

SYS 3 *4096 
SYS 7 *4096 


The loaders are about 512 bytes long and all operate in the same 
manner. When activated, the loaders print a copyright notice 
and prompt the user for a load offset. The offset is used to 
place object code into an address range other than the one that 
it was assembled into. This allows the user to assemble for an 
area where there is no RAM and load into a RAM area. The object 
can then be programmed into EPROM etc.. 


The offset is a two byte hexadecimal address that is added to 
the program addresses. If the program address, plus the offset, 
is greater than $FFFF, the address wraps around through $0000. 
Xf no offset is required pressing the RETURN key defaults to a 
zero offset. The following examples show how offset works. 


Address 

$0400 

$3000 

$9000 

$E000 


Offset 

$0000 

$0000 

$D000 

$4000 


Load Point 

$0400 

$3000 

$2000 

$2000 


After the offset is entered, the loader will prompt the user for 
the object filename to be loaded. The loader will then 
initialize both drives, search for the file and start the load. 
AS t he data is loaded, the program will print the input data to 
t he CRT. This is for user feedback only. When the load i s 
completed the loader prints the message 'END OF LOAD' and 
returns to BASIC. 


■re are three errors that can happen during a 

Tn considered fatal; the load is terminated, the 
a f e d and control i s returned to BASIC if 
cl °„,intered. The following is a list of possible 

%°id be sel£ ^ ocume nting. 

BAD record count 
NON~RAM LOAD 
CHECKSUM ERROR 


load. p r 

, . Cir rocs 
°b]ect file is 

an error j, 
6rr0rs ' which 


The 


„. f ,TlON: in 

C .^t-EDITOR 


mini 

the 


compu ter 


HI-LOADER (MID-LOADER for 
load into the same RAM area 
before using these loaders 


I6K machines) , 
You must cold 


the 

start 
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EXTRAMON COMMANDS 


SIMPLE ASSEMBLER 

.A 2000 A9 12 LDA #$12 
.A 2002 9D 00 80 STA $8000,X 
•A 2005 DEX:GARBAGE 

In the above example the user started assembly at 2000 hex- The 
first instruction was load a register with immediate 12 hex. In 
the second line the user did not need to type the 'A' and 
address. The simple assembler retyped the last entered line and 
prompts with the next address. To exit the assembler, type 
'RETURN' after the address prompt. Syntax is the same as the 
disassembler output. A ':' can be used to terminate a line. 

BREAK SET 

.B 1000 00FF 

The example sets a 
the instruction at 
command (see later) 
first occurence of 

DISASSEMBLER 

.D 2000 
., 2000 A9 12 LDA #$12 

2002 9D 00 80 STA $8000,X 

• , 2005 AA TAX 

Disassembles to the end of memory starting at 2000 hex. The 
three bytes following the address may be modified by using the 
cursor keys to move and modify the bytes. Then hit 'RETURN' and 
the bytes in memory will be changed. Extramon will then 
disassemble that line again. 

•D 2000 3000 

This disassembles from 2000 to 3000 
enable stop 

• E 


break at 1000 hex on the FF hex occurence of 
1000. Break set is used with the quick trace 
. A break set with count blank stops at the 
the break address. 


This 

inter 

press 


r 

i 


allows an exit from 
apts are still operating 
9 the STOP and '=' keys 


machine programs, 
the program may 
at the same time. 


.F 


1000 UOO FF 


If keyb° a ^ d 

be stopped y 


This 
hex . 


fill 


s the 


memory 


from 1000 hex 


to UOO hex with 


the byte FF 
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GO RUN- 


.G 

Go to the address in the PC register display and begin running 
code. All the registers will be replaced with the displayed 
values . 

.G 1000 

Go to address 1000 hex and begin running code. 

HUNT MEMORY 
.H COO0 D000 'READ 

This hunts through memory from C000 hex to D000 hex for the 
ascii string 'READ' and prints the addrhss where it is found. A 
maximum of 32 characters may be used. 

.H C000 D000 20 D2 FF 

Hunt memory from C000 hex to D000 hex for the sequence of bytes 
20 D2 FF and print the address where it is found. A maximum of 
32 bytes may be used. Hunt can be stopped with the STOP key. 

INTEGRATE MEMORY 

.1 F000 

F000 54 4F 4F 20 4D 41 4E 59TOO MANY 
*' F008 20 46 49 4C 45 D3 46 49 FILESFI 

This displays hex and ascii until the end of memory. 

z F000 F080 

This displays hex and ascii from F000 hex to F080 hex. 
f nMT __FROM TAPE 


.L 

Load a;Y program from tape *1 


L -RAM TEST" 

Load trom tape 

TEST",02 


♦1 the program named "RAM TEST' 


■RAM 


Load from 

load “fEhe GO 
not: use."* 

the monitor. 


program named "RAM TEST", 
breaks the IRQ saved by the 
command after load. Exit to Basic 


tape #2 the 
a file name 


Beware 
monitor. 


and 


that 
Do 


re ~enter 
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MEMORY DISPLAY 

.M 0000 0080 

0000 00 01 02 03 04 05 06 07 


0080 08 09 0A OB OC OD OE OF 

This displays memory from 0000 hex to 0080 hex. The bytes 
following the address may be modified by editing and then typing 
a return. 

NEW LOCATER 

.N 7000 77FF 1000 0400 8000 
.N 7000 77FF 1000 0400 8000 W 

This relocates machine code from 7000 hex to 77FF hex to a new 
location at 1000 hex. New locater fixes all 3 byte instructions 
in the range 0400 hex to 8000 hex. The 'W' option will relocate 
.WORD tables only. The new locater will not move instructions 
of 00, so transfer the tables first, then zero tables in from 
the copy. New locater stops and disassembles on a bad OP code. 

QUICK TRACE 


• Q 

.Q 1000 


The first example begins trace at the address in the PC of the 
register display. The second begins at 1000 hex. Each 
instruction is executed as in the walk command, but no 
disassembly is shown. The break address is checked for break on 
the n'th occurence. The execution may be stopped by pressing 
the STOP and '=' keys at the same time. 

register display 


PC SR AC XR YR SP 
0000 01 02 03 04 05 

• f 

This displays the register values saved when extramon was 
entered. The values may be changed with the edit followed by 


return. 


RbTunn . ~~~ - - 

single stepping with .W . 

RAVE TO TAPE 


Use this instruction to set up the pc value 


PC value before 


,S "PROGRAM NAME" , 01,0800,0C80 



with a 
use the 


hex 








transfer memory 
.T 1000 1100 5000 

This transfers memory in the range 1000 hex to 1100 hex, and 
start storing it at address 5000 hex. 

UNDO STOP KEYS 


•U 

This disables exit from machine language programs with the STOP 
and keys. 

* WALK CODE 

. W 

Single step starting at address in register PC. 

.W 1000 

Single step starting at address 1000 hex. Walk will cause a 
single step to execute, and will disassemble the next 
instruction. You can control the_speed with the following keys 


'<' for single step 

'RVS for slow step 

'SPACE for fast stepping• 

EXIT TO BASIC 

.X 

This returns to Basic ready mode. The stack value saved 
when entered win be restored. Care should be taken that this 
v 3 In c is the same as when the monitor was entered. A C E R in 
Basic will fix any stack problems. 
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MONITOR INSTRUCTIONS 


( 



G - Go run 
L - Load from tape 
M - Memory display 
R - Register display 
S - Save to tape 
X - Exit to Basic 

EXTRAMON INSTRUCTIONS 
A - Simple assembler 
B - B r eak set 
D - Disassembler 
E - Enable stop keys 
F - Fill memory 
H - Hunt memory 
I - Integrate memory 
N - New locater 
Q - Quick trace 

_i 

T - Transfer memory 
U - Undo stop keys 
y - Walk code 


X. 
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SECTION VII 


DEVELOPMENT AIDS 


DOS Wedge 
PET Emulator 
Sound Editor 
Sprite Editor 
Character Editor 


(DOS 5.1) 
(CBM64 TO PET) 
(SIDMON) 
(SPED) 
(CHRED) 




PET EMULATOR 


(CBM64 TO PET) 


The program "CBM64 TO PET" is a short form emulator that relocates the 
screen and BASIC to the following locations: 


Bottom of BASIC $0400 
Top of BASIC $8000 
Screen $8000 

Note: The STOP/RESTORE function will NOT bring the CBM64 back to it origins 
state after this program is run. 


r 

v 
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PREFACE 


The Commodore PET EMULATOR software package allows you to 
execute programs that were originally designed for the Commodore 
PET computer on the new Commodore 64. 

i 

The PET EMULATOR modifies the CBM Model 64 so that it will 
operate identically to the 2.0 Basic PET 2001 in most respects. 
This modification consists of two parts: memory re-configuration 

and system interaction interpretation. The exact technical 

specifications of just how the PET EMULATOR operates are well 
outside the scope of this document, however the more important 
conceptual information of its operation are presented. 

It is recommended that you read the entire document before 
trying to use the EMULATOR to ensure that your first expe ience 
will be a successful one. 


i 





USER CONVENTIONS 


It is recommended that you familiarize yourself with the 
Commodore keyboard. Here is a brief description of certain keys 
and symbols, and their respective function in reference to the PET 
EMULATOR and this manual. 


Up Arrow The Up Arrow character, on the upper 

left corner of the keyboard, is used to 
load and execute program. 

/ and % These two keys are used to load a 

program into the computer's memory. A 
more definitive explanation will be 
presented later in this manuc 1 . 

@ and Greater Than These two keys are used interchangeably 

as the command prompt for the emulator. 
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1.0 Getting Started 


The operation of the PET Emulator is not only simple but really 
transparent to the user. It was designed by Commodore for one 
reason only: Software Compatability. It is our desire that you 

find the program useful and of real benefit. Please take a moment 
to make sure that you have the following equipment connected 
; properly, as per the instructions in the Commodore 64 User Manual. 

1. Commodore 64 

2. Commodore 1541 Disk Drive 


l.l Loading the PET Emulator 


On the diskette contained in the package rhere is a small program 
that will load and execute the PET* Emulator, the Emulator itself, 
and several PET Public Domain programs for your enjoyment. 

To load the PET Emulator type: LOAD"*",8. After the computer 

replies READY, type RUN. This will load and execute the Emulator. 
You will notice a message appears on the screen indicating that the 
Emulator is loaded and running. 


2.0 Theory of Operation 
Memory Configuration 

The CBM 64, in normal operation, stores BASIC programs in the $0800 
to $9fff memory range (HEX), with the screen stored at $0400 to 
$0800. The PET stores BASIC programs at $0400 to 47fff with the 
screen stored at $8000 to $8fff. ’ 


The Emulator re-conf igures the Commodore 64 


so that it 

. .. POKES to 

the program, and other such direct access operations work properly- 


duplicates the PET internally. Thus POKES to the^Tcreen,- 


System Interaction Interpretation 


Many PET programs access the system direct 
WAITS. Most of the common PEEKS, POKES 
by the Emulator and should operate exact 
PET. These locations are as follows: 


■y with PEEKS, POKES 
and WAITS are interpr 
ly as they would ° n 


and 

eted 

the 
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Location 

PEEK 

POKE 

Operation 

50003. 

X 


BASIC version type test 

59464 

X 

X 

CB2 sound frequency 

59467 

X 

X 

CB2 sound on/off 

59466 

set to 15 



59468 

X 

X 

Set upper/lower case 

All POKES 

and PEEKS between 

$0000 

and $03ff (when possible) are 

translated. 

POKES not able 

to be 

interpreted return the message 


'illegal quantity error'. 

Cassette buffer //2 
(same as the PET), 
system routines will 
this cassette buffer. 

The CB2 sound is emulated as closely as possible. Certain very 
high tones available on the PET can r.ot be obtained on the 64, and 
the pitch of the tones varies across the scale. Musical tunes may 
not be emulated correctly, but other sound effects usually sound 
better under the emulator than they may have on the PET. 


is also available for machine code programs 
Machine language programs that do not call 
work with no modifications if they reside in 


3.0 Operation 


The Emulator loads into high memory on the 64, $C000 (HEX). It may 
be loaded directly by typing: LOAD"EMULATOR™,8,1 and then after 

the computer replies READY, type SYS 12*4096. As stated above, the 
first program on the diskette is a program that will I oacl and 
execute the Emulator for you. In addition this program contains 
the logic to allow screen color selections before actually loading 
the Emulator. 


4.0 DOS 5.1 


Included on the diskette, and operable with the Emulator, i s 
another valuable product from Commodore, the DOS 5.1 Universal Disk 
Operating System program. This program is more commonly called the 
DOS Wedge because it 'wedges' itself in between the computer and 
the disk drive to facilitate disk operations such as LOAD and SAVE. 


The DOS Wedge 

communicating with 

do anything more 
program, >>u, allows 


provides a very useful 'short cut' method of 
^he disk drive. It cannot make the. disk drive 
than can be done through commands i n a BASIC 
the user to communicate in a direct mode. 


This version of the DOS Wedge will actually allow the 
cornmands to e given from within a BASIC program as w ell. 


'short 


form* 
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4.1 Command Summary 


Normal DOS Wedge Commands 
up arrow Load and Run a program 

/ Load a program into the normal BASIC 

prjogram area 

% Load a program into the area in memory 

dictated by the programs load address 


left arrow 

Save a program 


@ 

Read and display the disk drive error 
channel 

X 

<r> 

D-'play the directory of the disk 
cL’ive x (ie. @$0 for drive 0) 

in 

@$x:pgm* 

Search the directory on drive x 
the files *hat begin with 'pgm' 

for 

@n:name,id 

Header a NEW disk, using 'name' 
'id' 

and 

@r0:a=b 

Rename file *b* on drive 0 to 'a' 


@c0:a=0:b 

Copy file 'b' on drive 0 to file 
on drive 0 

'a' 

@s0:name 

Scratch file 'name' on drive 0 


@uj 

Reset disk drive 


@//9 

Slsa:. .'Sfu.m'v , u o%’ numb - ,rom 

the 

@q 

Emulator™ D0S and 

the 

@ix 

Initialize disk drive x 



Pile names for the LOAD and SAVE commands 
anywhere on a line of the screen (as in a 
all other extraneous information on the line 


is 


aiay be within quotes 

directory listing)* an 
ignored. 


Using the DOS Wedge from within a program: 


10 INPUT "DO YOU WANT TO LIST THE DISK DIRECTORY". A 4 
20 IF A$="Y" GOTO 40 ^IORY-jAS 

30 STOP 
40 @"$0" 
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5.0 Combinations of Mode/Memory 


New commands added to the DOS Wedge to support the Emulator 

include: 

@m toggle memory configuration 

@e toggle emulate mode (PET/64) 

Either of the latter two commands will display the current 
mode/memory status. The @m command ’news*, erases, the BASIC 

program currently in memory. Therefore, 'are you sure' is asked 

before the command is executed. 

The emulator normally loads up into the PET memory mode with the 

PET emulator on. Thus four combinations of mode/memory exist. 
When changing modes warnings are printed where potential confusion 

exists. Now once the computer is in PET memory mode with the 

Emulator on, the system operates as a PET as described above. When 

in 64 memory mode with the emulator off, the emulator has no effect 

on the normal operation of the Commodore 64. 

Please note that when in the PET memory mode the RUN/STOP key is 
disabled. 


e pgr Emulat° r 
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SOUND EDITOR 


(SIDMON) 

SIDMON allows you to create sounds by editing the SID chip registers. 
(A detailed description of the SID chip can be found in Section II of 
this binder.) To load SIDMON enter: 

LOAD "SIDMON",8 
RUN 

The following screen.will appear: 


MODE: 


** * 

SIDMON 

1.3 

*** 


(FREQUENCY 


[pjULSE WIDTH 





5000 


1024 





5000 


2048 





5000 


3072 





[ATK (DEC 

f?s 

Irls (gJate gxfrc 

F@NG 


n. n 

* 

1 3 

13 

10 0 0 

0 

0 

0 . 0 

0 

1 3 

13 

10 0 0 

0 

0 

0 0 

0 

1 3 

13 

10 0 0 

0 

JL 

A 0 

0 

FIL'TER: 

0. 


RESONANCE: 0 


01 

& m 

a 

0 

0 




S3 

UP/DN/ON/OFF 


(for voice 1) 
( " 2 ) 
( " 3) 


(for voice 1) 
( " 2 ) 

( " ' 3) 


iLbw [BAND [HIGH [5 uT3 
0 0 0 ~~0 

MASTER {VOLUME : 15 


SI divide by two 
1 multiply by two 


dOTOFF FREQUENCY: 0 
VOICE: (faj/^tFl) : 1 


ommands are entered by pressing the reversed key (n\ __ . . ^ u.-it-h that 

unction. Up/down and on/off settings are controlled hv sociat ® the "+" 
nd keys. This is best described by using examples? P cessing th • 

First select your wave form ( /A '- ^ 1 ' * ) by . 0 , r 4. 

Then, gate the sound ON by pressing "G" * 1 ' 2 ' 3 ° 

Next you can alter the f equency by pressing »pn L.. * . bv . 

1 + tQ ra ise the frequency r • followed by. 

to lower the frequency 
M to multiply the frequency by 2 
D to divide the frequency by 2 

Attack, decay, sUS J: a iE' release, etc. can be ^ n the same 

manner. Any one of the three voices can be selected by Fl/ f3 ' or F5 ' 

fter creating th e desired sound, jot down the numbers in the registers for 
ater use in your programs. oers in 
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cccc 

N_' *— * 

nun 

DDDDD 

MMM 

MMM 

ODD 

NNN 

NN 

OO 

ii 

DD 

DD 

MMMM 

MMMM 

00 00 

NNNN NN 

cc 

oo 

ii 

OD 

DD 

MM MM 

MM MM 

00 

00 

NN NNNN 

ssss 

ii 

DD 

DD 

MM MMMM MM 

00 

00 

NN 

NNN 

ss 

ii 

DD 

DD 

MM MM 

MM 

00 

00 

NN 

NN 

ss ss 

ii 

DO 

DD 

MM 

MM 

00 00 

NN 

NN 

ssss 

iiiiii 

DDDDD 

MM 

MM 

000 

NN 

NN 


Sound I n*ter-face Device MON i “tor 


„ .. ■ .u . 


-vu • ito \+ x'-'- '* 


' *• '* U * 
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I OMOM 



SIDMOH is a program which -allows you to create sounds using the 
6581 Sound Interte.ee Device in the Commodore 64. It is difficult to 
random ly try different sounds or keep poking around until you get the 
sound you want. SIDMON does all of the poking -Por you. Vou just look 
at the screen and change whatever you want. I-P you don't like the 
change, change it back. It's that simple to use! 

The commands are usually the first letter of the register name. 
In some cases though, the letter has already been taken by another 
command, so the second letter is used instead. -The proper letter to 
press is highlighted in reverse on the screen. 

First, lets review the descriptions of the different registers... 



FREQUENCY : This register sets the number of 


sound waves per sec and 


produced by the SID 




t t 


pu Ise 
width 


FlTTRCK : The attack rate determines how rapiej^y ^ 
rises from zero to amplitude when the y oir 


v °ice is gated 










» i II II V-JI II— 


DECflV 2 The decay eye le to 1 lows “the attack eye le and “the decay rate 
determines how rapidly the output tails trom peak amplitude to the 
selected sustain level. 


SUSTAIN : Vou can select 1 ot 16 sustain leveIs tor the voice, 
sustain cycle to l lows the decay cycle and the voice will remain 
-•elected sustain leve l as long as the gate bit remains on <1). 

RELEASE : There are 0 to 15 release leve Is ot which one can be 
selected. The release cycle to l lows the sustain cycle when the gate 
bit is turned ott (reset to zero). At this time, the output ot the 
voice being worked on will tall trom the sustain a/nplitude to zero 
amplitude at the selected release rate. 


The 

at the 


A 

M 

P 

L 

I 

T 

IJ 

D 

E 



Gate 

Gate 


on <1> 
ott (0) 


GATE : When the gate is set to a one, the attack/decay/sustain cycle 
begins. When the gate is reset to a zero, the release cycle beuins 
The ga.te must be set tor the selected output ot the voice to be 
audib le. 


SVNC 5 The sync, when.set to a one, synchronizes the tunde/nental 
frequency °^ Tb*=* ^ice being worked on with the treguency c ,^ 
Varying ^ r ’= , ‘ :iuef the present voice with respect to voice 3 


ce 









produces a wide range of harmonic structures from the present voice at 
the frequency of voice 3. In order for sync to occur, voice 3 must be 
set to some frequency other than zero but prefereb ly lower than the 
frequency of the present voice. No other parameters of voice 3 have 
any effect on sync. 


RING : The ring register, when set to a one, rep laces the triangle 
waveform of the present voice with a ring modulated combination of the 
present voice and voice 3. Varying the frequency of the present voice 
with respect to voice 3 produces <a bell or gong—like sound. 


The triangle waveform has a mellow, flute-like -quality. 

Ns The sawtooth waveform is rich in even and odd harmonics and has a 
bright, brassy -quality. 



fl : The harmonic content of the pulse waveform can be adjusted by the 
pulse width register, producing tone -qualities from a bright, hollow 
square wave to a nasal, reedy pulse. 


* : This output is 

from a low rumbling 


a random signal, 
to a hissing white 


The sound -quality C3n be 
noise via the frequency 


varied 


register. 


PTLTER : When set to a zero, the present voice 

*-r--ars directly at the 


audio output and the fi Iter has no effect on the sound i-f 
one , the present voice will be processed through the filter 
' harmonic content of the voice will be altered. 


se’t to a. 
and the 
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RESONflHCE : This register contro Is the resonance of the -Filter. 
Resonance is a. reeking e-f-fect which emphasizes frequency components at 
the cuto-F-F frequency of the -Fi Iter., causing a sharper sound. There are 
16 resonance settings ranging linearly -from no resonance <0> to maximum 
resonance <15 > . 

LOW s When set to a one., the low pass output o-F the filter is selected 
3 rd sent to the audio output. For a given fi Iter input signal, all 
frequency components above the cutoff are attenuated at a rate of 12 
dB/octave. The low pass mode produces full bodied sounds. 

BAND • Thi_• i-• -=■ imi la/* to LOW but, all frequency components above and 

be lc "" the cuto ‘ f ‘ f 5r-e a.t-t@nua.ted at a rate of 6 dB/octave. The band 
pass mode produces thin, open sound. 

HIGH : This is the opposite of LOW, in that when set to a one, all 
•frequency components below the■ cutoft'are attenuated at a rate of 
1 2 dB/octave . This mode produces a tinny, buzzy sound. 

CUT 3 : When set to a. one, the output of voice 3 is disconnected -from 
the direct audio path. Setting voice 3 to bypass the -fi Iter and 
.setting cuto-f-f 3 to a one prevents voice 3 -from reaching the audio 
output. This allows voice 3 to be used -for modulation Purposes without 

^ r .y undesirable output. 

MASTER VOLUME : Select one o-f 16 overall volume levels -for the final 
:+o audio output. The values this register can ho i r j 

compos- 


range from 0 






<no sound) to 15 '(max sound). 

CUTOFF FREQUENCY : This register is set to contain a. number which 
contro Is the cuto-P-P (or center) frequency of the progra/nab le -filter. 


:=: X D r-10 M C O M M FI M D S s 

There ere several commends that are used in SIDMON. These 
commends, as mentioned be-Pore, ere highlighted on the screen in 
reverse. When a valid key is pressed, that key is displayed next to 
“MODE:" on the top line. The only keys that will not be displayed ere 
+ , -, M end D. For these keys to have any e-P-Pect, another letter must 
already be displayed next to the mode. 


CLR HONE : To comp letty reset SIDMON press the <SHIFT> and rCLR HGME> 
Rll o-P the values will be reset to their default. NOTE: RNY CHANGES 
VOU HAVE MADE WILL BE LOST!!! 


PI, F3 end F5 
that you are 
F5 is voice 3 
n^xt to where 
2cr , ="= , n • 


: These three function keys 


WJ c '.1J 


se lert the 


currently working on. FI is - v <oic^ 1 c-, . _ . 

• ro i s uoice 2 and 

. The voic* ttwt is beinc, , orttM on i$ noted 

it says "VOICE <F1,F3,FS>," on th* botto„ Un . the 


+/- : The add end subtract keys are used to 


raise r 


lower 'ja. lues * n 


the di-Pferent registers. In some cases, such -as M , hich is either 

f 'd the rn i nus <' 


0 ff or cr'i, the plus < + ) [< * y is used to turn on and _ __ <■-) key 


Jt v 


vi 







c. lUI'IUM MMMUML 


— fz> 


used to turn o-f-f. 

M/D : The "M" key and the "D" keys are used to multiply or divide 
respect iv ly. These keys work on ly on -fraguency end on pulse width. 

F : Th»=* F key is used to select -frequency. Follow this key with 
either M or 0 to change the -fre-nuency. Whi le in -frequency mode, 

the plus end minus keys add or subtract IS -from the frequency o-f the 
voice that you are working on. I-f you on ly want to add 8 to the 
-frequency, mu Kip ly the -frequency by two by using the "M" key. Then, 

using the " + " key add 16, then divide by 2. Vour frequency should now 
be 8 more than when you started. 


The pu Ise width mode i: 


p : To select pulse width, press the "P" key. 

simile to the -frequency mode. The oh ly di-Merence is thet the plus 
s „d minus keys change the pulse width by S 4. Remember, pulse width 
only app lies whan you <*ra using s guar a wava. 

R, 0, S and R : These keys select attack, decay, sustain and release, 
respectively. The values o-f each range -from 9 to 15. Plus and rninv- 
change these registers by 1. The "M" and "D" keys do not work while 
this mode. 


c . This key selects gate. R one < + > in this register starts the 
attackr 5nd s, -»srfcain. When reset to a zero <->, the 

«eguence begins. This register must be manipulated -for y 0lJ -(. 0 ^ 

sound -from 


the SID. 


-«£.v- *«> •> • 


- ,**&:*& 






V and I : These keys select sync end ring. On end off are the on ly £• 
states these registers can have. The + key turns the register on end 
the - key turns it off. 

9, 1, 2, 3 end 4 : Keys one thru -four select the tyre of wave-form that 
the voice you ere working on will have. The "1" key selects triangle. 
"2" selects sawtooth. Pulse is chosen toy pressing the "3" key and the 
"4" key selects noise. For pulse width to have any effect, the pulse 
wave-form must be selected. Only one o-f these -four choices may toe on at 
any one time. The 0 key will turn o-f-f all wave-forms. 

T : This selects -filter. fis in gate, sync and ring, the -filter has 
either an on or an o-f-f state. 

E : Resonance can toe set by pressing the "E" key. It has a range o-f 0 
to 15, which can toe modified toy using the + and - keys. 

V : SIDMON has a master volume which can toe changed by pressing ■ h V" 
fo l lowed by + or - keys. 

U : The cutoff frequency is selected toy pressing "U". This, followed 
toy + or -, changes the cutoff frequency. <Divide and multiplv rjoe- not 
work in this mode.) 




I •• <• »•_*! I*_ 


Try to recreate this sa/np le 


MODE: 
FREQUENCY, 
4968 
5900 
5032 


*** SIDMON 1.4 mw. 
PULSE WIDTH 
1024 
2043 
3136 


RTK DEC SUS RLS GATE SYNC RING /\ N fl # 


13 

13 

13 


10 

10 

10 


0 

0 

0 


0 

0 

0 


FILTER; 

0 

0 

0 


RESONANCE: 0 


LOW BAND HIGH CUTS 
0 0 0 0 

MASTER VOLUME: 15 

CUTOFF FREQUENCY: 0 

VOICE <Fl,F3,F5>: 1 


UP/DN/ON/OFF 
DIVIDE BY TWO 
MULTIPLY BY TWO 


For rfi - ormation on the SID, see the Programmers ' Reference Guide. 



• ■ . * ’Lw. .1 \ „ • : 








CHRRPCTER EDITOR 


:he characters that are Printed onto the screen through PRINT 
svanenents ; -® r statements to screen memory) are sto~ed * - w 

• 3 - r>: ^WO such character sets, each occupying 2K -r 234:5 V h-1-V* 

i i he usual GRAPHICS* character set 'POKE 3A27-• • > 

2> The LOWER CASE character set ^“T^P 

— i •. u— ■_• cl t cL .* d o .. 

On the COMMODORE 54, it is Possible to have chare rte>- _ v _ _ , . 

RSM " *re theoretically Possible - 3 are actually n^ahL ’"' = "" " lr> 

• he RPM character sets are numbered 8-7. Each set ocn-pi^ --y ...> 
memory anc is adivatw by Pok ins resists:- 24 of the - 

memory location 53272> with an appropriate number -"**• 


ChPRPO' 


LOCriTION 

EMPBLE 2I-V 

0 - 

2847 

r~, <“> \S r“ 

33272,17 

2343 - 

4833 

POKE 

33272,13 

4935 - 

5143 

poke 

EC ~tr», 4 

•JC'CL i d .• Cl 1 

5144 - 

<» / 

O .L J? X 

POKE 

rO'T '7 

•w* d i d .* cl o 

81 92 - 

18233 

POKE 

~ -r 

•J d s d .< d 

13248 - 

1223 7 

POKE 

c ;';07 'T* -7.-7 

c. 1 c- .< d t 

12238 - 

14335 

~ wi\u. 

3327223 

14335 - 

16333 

POKE 

33272,31 


•. > Character Set 8 is not available since this 
rrt or memory is used by the operatives 
system arid screen memory. 


25 The Pokes that enable Character Sets 2 
x ■ : ~ • arsis ie tre ROM character sets. 


o C. 


Thvthe only character sets th"f 5 • ._ 

■ . f •-**. o. i u CJ •, c* v .. 

sets i, 4, 5 , S, and 7. Since these sets are ; nrs‘s« 7. 



•'-is -vpRPC'ER EDITOR allows you 
■' iv f -vaf. able char act© 

*e used within your Programs 


*• *,», “ •. «, „ 1 j ♦ 


"he--e are two distinct modes in . :J _ , : _ ; - 

com.-,lands - oxrr??cTER SELECTION NODE and EDI’ r WCDE. 


c ci'sate.- ed--- 

sets. R«y s--t create L-. - ’ i'" 1 -- sux- of the 

:J "' 'S'-Ved r.o disk 

- its own sen ! - ;J 






CHARACTER 


MODE 




r i s 
r U, 


....... is- -cn© rftcde that the Character Editor starts with when it is 

~_, x l V"? Y'? x ~' r " oc ^'-' a box cursor flashes over one of the 64 

-5^*7® , QiS? ’ a y®d near the bottom of the screen < whenever this box 
sur T r^.snes.. you know that you are in CHRRRCTER RF! E-crmw motif ..... 

in EBIT MOBE5. 


-r 1 iwwn '•.wrenever or:is box 
CHRRRCTER SELECTION! MODE and not 


:- ' J ' r '~' C:r c ~-' n he moved from character to character us in-3 the norma' 
17 ! U ~ WC_ c * owrs ' ls-ft.• and ri9ht>. When the cursor is Positioned 

C--' r;:" C ;?r aC ^: you to Press the RETURN key. That character 

^ EEIT GRIB at the upper left of the screen 
1"' li9 ' ■ character will also be displayed to the risht of 
j.’.. a., au a each of the iS colors. 

—_. ’..ty A " •-haracter Selection Mode., several commands are available. 

■-•-e summarized in the following table. 


Ks'r strok e 


Effect 



f — 

*-r i ., 

DU!N 


C • Rl-*c 


Cry C"‘ the £ 
k?’rS ’1-7, 


•‘‘loves the box cursor to any of’ the -34 characters 
d i s P 1 a y e d o n t h e s c r e e r. 

dot sets the character under the cursor for ed i t i n9, 
ure character is displayed or the EBIT GRID arid 
cjjI i MODE is entered. 

Displays the NEXT 54 characters of the Present 
'-raracoer set at the bettor:*; of the screen \ There 

characters in each character set.* but only 
Sr 5 * r : =‘ ! ~ 1 s f 1 *?• s* o a t a n y 9 i v e n t i ;:*i e ) , 


GtePs through each of the IE BRCKOECUNB colors, 
-•ceps through each of the IE EDGE 1Border) colors. 


i.‘ 1 ' ’• * 3 - -• t»n S’ c o re s P c n d i n g c h a r a c t e r s e t« 1 ft c t e ’ 
j?.r-.s.:.ter oets 2 and 3 can be displayed but since 
•-'> i. ; =y are in xOM they car?not be edited.) 

- H ^ a s P e c i f i .9 d •- h r . - ; c t. ; .r- ^ fc f r o p: d i s k i n t o 

Memory. 


7* ’ ’’ c te c h arac te r e•>.. p s sent <. - b e i r 9 e o’ i te d , 
'*y Vou are Pr or “ted •‘"'or a 1 1 snare and the 

of the set you ... ish to eave that set to. 

: ^ “ :ou • 5 * r; ~ - resent 1 a editing Character 

.•."f say.- you can still save in zo Character 
* * 4, 3 . E, or 7 in J c -„: wish.) 

O*; - - , 

; J * ‘ "-ns editor. Cnee you have *lUit the editor - 

restart it, with al" character sets i- 

s 1 ’ y ba tyPin -2 run. GNRR 300" 

: - ! 9rari*; does not have to be reloaded and run- 



EDIT MODE 

Tn J=* c O r**i =;. d S V a 1 1 a Q 1 1 =- i n 
the commands aval Table to the 

T h e 7 * o 11 o *.v i n 9 c o m mn d s 3. r• e 
1 instruct i oris > - 


Edit Mode 3 .re eldest exact 1 y 
SPrite Ed1tor, 

exactly the same <See the 3 - 


the same as 

rite Ed 1 tor•'s 


•O 

CRSR-R■ 

CR8R—L 

FT, CR8R-UP, CR3R-2WN. 

b> 

SFRCE, 

r** 

.'_• Z. s— .» « 

HOME, RETURN, CLR. 

c *:• 

CTRL-R, 

F1 .> F2 .• 

F3, F4, &. 

d J 

C“RL-3, 

CTRL-E. 



he vq \lewiro commands are not 
o 1 y t o c h a r a c t e r s e t s, 


ifii? lemented, simp In because they 


00 


-O CTRL-?, + , - , CTRL-D, CTRL-C. 
b> > , CTRL-ik, CTRL-V, CTRL-V. 


Note- 3 and CTRL-L are net implemented in Edit Mods-, 
Character Selection Mode. 


ov^ able in 


'3N3L f3UM3ND3 


This allows the character be in:-: edited •-•- —. 

to some character in the character r "^XT"^' 

is Pressed, the box cursor f’a-=he- . "' Jl ' ls 1: 

originally selected. The edited 

assigned to this character or to crhuT. . ^ “** •-.. 

first using the cursor keys and/or 
one cursor over the desired char = •-!-•— '• fi 

.-•--essins RETURN. * ! T-nen 


Pressing 3 in Edit Mode allows 
Character Selection Mode without 
character to any _ 

’ r ’ : ^ 2 . o e o c h a r a c t e r .• h o w e •«/ e r 


ch«r*ct*r i„ 

t«r, hwwr, is Tcli*' 


QTc ' 


• O V.Sc 

•. o a o o 


the 

and ran 


Character Edi 


•or 


‘ i rs*‘ 


t-re 


” c » r * ■?. m o -c - 


must 





SPRITE EDITOR 


The data that defines a 
consecutive bytes cal1ed a 
associated with the 6502 or 
theoreticaIly pcssibIe, out 


•sprite on the Commodore 54 is stored 
y Pa9e<this is not the usual Page o 
5310 >« UP to 256 sprite definitions 
not a11 of these are avai1able. 


in 54 
uncePt 
are 


The sprite Pa9es start at the beginning of memory.. so for example, 
Pa9e 8 occupies memory locations 8-63.* Pa9e 1 occupies locations 64-127.. 
and so on. Pa9e 32 be9ins at 32#64 = 2048 and extends for 64 bytes.. 

?a3e 130 begins at 153*64 = 9600, and so on. 


f*'? c G ^ ^° ^ e r ' a1 i n 9 s y s t e m u s e s m o s t o f t h e m e m o r y 1 o c a 11 o n s f r o m 

y-c.y4,3 r or ins own use, several Pa9es here will not be available 
for sP r me def i n i t i or•=.« Qthers a.re not ava i 1 ab 1 e as we 11. 

oere is what is available and what is not. 


Sprite Pages 
8-12 


13-15 

16-31 

32-53 

Ki' - — r 

123-255 


Pernory Locations 
8-831 
332-1823 
1324-2947 
2043-4895 <2K> 

4335-Si91 <4K> 

0132-15333 <810 


Status 

Not Rvailable 
Rvailab.le 
Not Rvailable 
Rvai1ab1e 
Not Rvailable 
Rvai1ab1e 


Reason 

OPeratino system 
C a. s s e 11 e b u f f e r 
Screen Memory 
See below 
I don’t know why!i 
See below 


• o r m a i i. y p a 3 <=• s 


—~-s 32-53 <sand some in the range 128-25;: 
available for sprite definitions since the BRSIC Program 
«owever^ it m easy to move a BRSIC Program uP in memory 
wisr. : rus this area can be considered as available for 


would not be 
is stored there, 
t o w h e r e v e r y o u 
use. 


-O'- example., to move- a BRSIC Program u.P so that it starts at 15334, 
:f,3 - ke 3-V.3. liable- RLL of the- room above, the follow ins sta-s are- 


1:' :'9 KE *6*1324,3 

15 Si S:}«« 


4> 


These step 


< Note ' 16# 1324= 15334 > 

< Norma 11 y th i s 1 ocat i on i s 1, so th i : 
•step may not be required. > 

usue 1. 


BOOT Program, : =. c . 

details- 

This Sprite editor 
definitions on any "If 
o u x 21 =■' r i d < m a t r 1 \ 


;Rlj VO'JR PROGRAM" as 
-• could be done in a small boot ProSram, such as the SPRITE 


• -i- U'.- I ic ill •- 1 . - , . - 

the user will not have to oe concerned v.'ith such 


f-1 lows yoy 
ehe-se P ages 


:o create, edi*£, save, esc. sprite 

.._• 4.2.2* created or edited - 


r p •••■ 1 te 


rz - O. O" „■ n ■■ 

USino the following command* 


L 




Key str-ok e 
CRSR-RT 


CR3R-UF 

CRSR-BWN 

SPACE 


Effect 

M o v e t h e c u r s c r < i n d i c a t e d i n r e v e r s e f i g-l d > 
one location to the right. When at the extreme 
: i 9 h t 6- n d o f a \ i n e .• t h e c u r s o r w i 11 w r a P 
around to the beginning of the same line. 

Move the cursor Position one 1ocation to the 
left. Wrap around can occur to the right of the 
same line. 

Move the cursor one line uP. Wrap around can occur 
to the bottom of the same column, 

Move the cursor one line down. Wrap around can 
occur to the top of the same column. 

Erase any Point Plotted at the current cursor- 
position. 

Erase any Point Plotted at the Previous cursor 
Position. 


Note : ;hese six commands are supported by the repeat kev 


- 

-lot 

a Point at 

HOhE 

Move 

the 

cursor- 

RETURN 

Move 

the 

cursor 


Wrap 

around can 




Erase- s a 11 Pol n t s o n t l-i © g r- i d. 


CTRL-S 

Reverses 

the entire 9rid. 

*— •: 

Move the 

entire 9rid uP one line. 

~ Cl 

Move the 

n t i r e 9 r i d d o w n o n e \ ... ^ 


Move the 

\ 

s n t i r e 9 r i d 1 e f t o n e 0 ,., m , 

-4, 

Move the 

s* n tire 9 r i d r i 9 h t c- n a 0 •»., f 

•y. 

R o t a t e s t h e s P r i o e 3 d e 9 r e e s. 

N o t e : R c t a t i n 9 a 2 4 M 21 s P r • 11 e . 


ot -ns s;-r sts t,o oisaPPp.*, = ■“ •- 1 -- - 

not square';. ~h-a ^ } r,ce it i* 

i n fact Preserved in a bu'fiU -* S5 ' P?ears '. 1S 
se-e-n by P"ess 1 nr the ' r -‘ can be 

- the- sprite should r OTiC ® *3ain 

Press ins it twice- in _1 -•;--^.oe- aown. 

will bring it back to” • 5 -' 3a - ir! 

Position - in tact, 

at any time will p-. t y il5 

EBIT mode. Whatever U," i'nto 

screen will be- stored - I?' 

definition and any th V T '* 

buffer will be lost.* ’* ® lSe ir; the 






CTRL-P 


Prompts for a new Pa9e number which is then 
displayed for editing PurPoses. 




CNTL-D 

C; 

CTRL-L 

CTRL-C 

CTRL-B 

CTRL-E 

y 

CTRL-X 

CTRL-V 

CTRL-V 


Display the sPrite on the next Pa9e for editing. 

Display the sPrite on the Previous Pa9e for 
editing. 

DisPlay a range of sprites for viewing only. 

Save a range of sprite definitions to disk. 

Load a Previously stored table of sprites into 
memory. 

Copy a range of sprite definitions from one area 
of memory to another. 

StePs through each of the 16 Background colours. 

Steps through each of the 16 Ed9e <Border) colours. 

Steps through each of the 16 sprite colours. 

ExPand/contract the sprite being edited in the 
horizontal direction Cacts like a toggle). 

ExP and/contract the sPrite being edited in the 
vertical direction <acts like a toggle too). 


Q 


View the sprite; currently being edited; 
moving randomly on a clear srreen. 

PRESSING 

SPfiCE stoPs the motion <Press SPHCE again to restart it). 

RETURN : returns you to the EDITOR. 

CTRL-B; CTRL-E; C-TRL-X; CTRL-V; and > have the same effect 
as above. 

+ speeds u.P the mo£ion. 

: slows down the motion. 

Quits the EDITOR. 

<Once you have 'luit the EDITOR; you can restarf • *. 
simply by typing RUN. Vou do not have to r» i 
the BOOT Program.) r «-load 


¥ . to use the SPRITE EDITOR; you must load and run the ^poT-rr. 

program first. • A ' t *00T 








SPRITE EDITOR 
(SPED) 


INTRODUCTION 

This program allows you to easily create and modify sprites on the 
Commodore 64. Many features to allow easy manipulation of sprites are 
included, as well as several commands to make the sprites created by this 
program usable by other programs. 1 


SCREEN EORMAT 

The screeen is basically divided into 4 areas by the sprite editor 
program. The first is the large sprite creation box. Here the sprite is 
formed using the and " " symbols. The horizontal axis of the box is 
lettered from 0 to 23, giving 24 possible bit positions. The vertical 
axis is numbered from 0 to 20, giving 21 possible bit positions. In this 

box, an entire sprite is represented. .^ 

The second area is the information box. Current sprite parameters are 
displayed here. Also, when a command needs a parameter to operate, a 
cursor will appear at the appropriate place in this box. 

The third area is the strip below the creation box. Here is where the 
sprite currently being edited normally appears. 

The fourth area contains the command menu, where most of the commands 
are displayed. However, the menu in the area under the information box 
can be replaced by the current sprite by the FI key. This is especially 
useful when working with expanded sprites. 

General Notes: The first letter of a command is enough, when a command 
requires an input (like sprite number), a cursor will appear in the 
information box. Type the answer there, ending it with a return. If vou 
type an incorrect letter, use the delete key. if y 0ur response " is 
illegal, the program will ignore it, keeping the old value of the 
parameter. 


. Viwv • *_• A' i. 


(SPED) cont. 


THE INFORMATION BOX 


The information box contains the following information: 


1 . 

2 . 

3. 

4. 

5. 

6 . 

7. 

8 . 

9. 

10 . 
11 . 
12 . 
13. 


PARAMETER 

Sprite number 
Name of current file 
Assumed address 
Range 

Type of sprite displayed 
Foreground color 
Multi-color register 0 
Multi-color register 1 
X expand 

Y expand 

X position 

Y position 

The bottom blank line of the i 
command inputs that don't need 


POSSIBLE VALUES 
0-47 

any 5 letters 

any 4 digit hex number 

0-47 

HIRES or MULTI 

any of the 16 colors 

any of the 16 colors 

any of the 16 colors 

YES or NO 

YES or NO 

0-319 

0-199 

[formation box is used for other 
to be continually displayed. 




r.tU- 






A. • * 






(SPED) cont. 


« 


COMMANDS 



1 . 

2 . 

3. 

4. 

5. 

6 . 

7. 

8 . 

9. 

10 . 

11 . 

12 . 

13. 

14. 

15. 

16. 

17. 

18. 


E(dit) : requests a sprite number from 0 to 47. That sprite becomes 
the current sprite. The current appearance of the sprite is 
displayed both in the creation box and the current display area. 
N(ext sprite) : selects the next sprite as the current sprite. 

T(ype) : selects between displaying the current sprite as a hires (h) 
or a multi-color (m) sprite. 

M(ove here) : asks for a sprite number. That sprite is copied into 
the current sprite. Note that this operation destroys the previous 
sprite. 

0(r) : asks for a sprite number. That sprite is ORed into the 

current sprite. 

C(olor) : allows choice of colors for the sprites. a cursor will 
appear at each of the color parameters in turn. Type the three 
letter abbreviation for the color of your choice for each register in 
turn. ' ~ 


X(pand) : selects expansion in the x and y directions. A cursor w ill 
appear at the XEXP and YEXP positions on the information box. Answer 
YES or N3 (or Y or N). 

P (osition) : allows specification of the screen position of the 
current sprite. 

R(ange) : sets a range of sprites for use with the SAVE idad byte 
and DISPLAY commands. The form is *#.## (i.e. 0:12), for first and 
last sprites to be affected by an operation. • 

D(isplay) : animation command. A time is requested. Answer with a 
number under 1000. Just hitting return allows animation root- 

keyboard control. To end the display sequence hit the retum^ev 
A(ddress) : this command selects the assumed address of the sprite 
data. This is used when the sprites are saved, if thev are .-pi^ded 
by a BASIC load command, that is where they will load ^ 

S(ave) : asks for a file name, then saves the a!rr a nt r,„oo of 

sprites to disk, as a program file using the assumed a^rfcc ? 
L(cad) : asks for a file name, then loads thf currfnfV.nrP of 

sprites from disk into the work area from that proor S ! 5 

B(yte) : asks for a file name, then saves theOP? 1 fll f* , 

sprites to disk, as a sequential file compatible ran ? e 

Assembler Development System. with Commoaore s 

Q(uit) : exits the program. 

Z : rotates the current sprite. First, the non*. „ . 

requested on the bottom line of the information 0f r0t2tl0n lS 

from 0 to 23, while Y values range from 0 to 20^-^ X v ? lueS , ran ®J 
rotation is requested. Following normal non *** 

angles are positive, while counter 

Note: often a sprite is distorted by rotation ^ gles are ne<pt 
FI : toggles the selection of the current snr^ from 

under the creation box to under the information ^splay area from 
F3 : step through possible screen colors. ^° x and back aga 











EDITING COMMAND KEYS 


These commands operate on the current sprite in the creation box. 


1. * : places a dot at the current cursor position. 

2. SPACE BAR : places a space (removes a dot) from the current cursor 
position. 

3. CRSR RIGHT : moves the cursor one position to the right. 

4. CRSR LEFT : moves the cursor one position to the left. 

5. CRSR UP : moves the cursor one line up. 

6. CRSR EOWN : moves the cursor one line down. 

7. RETURN : moves the cursor to the start of the current line. 

8. HDME : moves the cursor to the top left corner of the sprite. 

9. CLR : erases the current sprite. 

10. KVS : reverses the current sprite. 

: moves all dots on the current one place to the right. 

12. DEL : moves all dots on the current line one place to the left. 

13. + : moves all lines from the current line to,the bottom line one line 
down. 

14. : moves all lines from the current line to the top line, one line 
up. 


COIOR CODES 


BLK 

WHT 

RED 

CYN 

PUR 

GRN 

BLU 

YEL 

ORN 

BRN 

RD2 

GY1 

GY2 

GN1 

BL2 

GY3 
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CHARACTER EDITOR 
(CHRED) 


INTRODUCTION 

This program allows editing of single characters, or editing four 
characters at a time (a 16 bit by 16 bit character). When editing 
expanded charactes, all character editor commands are adjusted to operate 
on the expanded character. More details on expansion can be found under 
the X(pand) command. 


C 


SCREEN FORMAT 


The screen is basically divided into five areas by the character 
editor program. The first is the large character creation box. Here the 
character is formed by using the and " " symbols. In this box, an 
entire character is represented. 

The second area is the information box. Current character parameters 
are displayed here. Also, when a command needs a parameter to operate, a 
cursor will appear at the appropriate place in this box. 

The third area is the strip below the creation box. Here is where the 
entire current character set is displayed. Also, the character currently 
being edited is highlighted in black. 

The fourth area is the display area, where the current character 
appears. 

The fifth area is the command menu, where most of the commands are 
displayed. 


General Notes: The first letter of a command is enouah wv,<=r, , 
requires an input (like character nutter), a curX? Tin i * “TSf 

information box. Type the answer there, ending it with a rp+-„vT rf von 
type an incorrect letter, use the delete key. If reionse is 

illegal, the program will ignore it, keeping the old valuf^f the 
parameter. AU ' 




.: n.' • 











(CHRED) cont. 


THE INDEORMATION BOX 


The information box contains the following information: 


PARAMETER 

1. Character number 

2. Name of current file 

3. Assumed address 

4. Range 

5. Type of character displayed 

6. Foreground color 

7. Multi-color register 0 

8. Multi-color register 1 

9. X expand 

10. The bottom blank line of the 
command inputs that don't ne< 


POSSIBLE VALUES 
0-63 

.any 5 letters 

any 4 digit hex number 

0-63 

HIRES or MULTI 
any of the 16 colors 
any of the 16 colors 
any of the 16 colors 
YES or MO 

information box is used for other 
d to be continually displayed. 
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(CHRED) cont. 


COMMANDS 


s- 


V. 


1 . 


2 . 


3. 


4. 


5. 


6 . 


7. 


8 . 


9. 

10 . 


11 . 


12 . 


13. 


14. 

15. 


16. 


17 . 


E(dit) : requests a character number from 0 to 63. That character 
becomes the current character. The current appearance of the 
character is displayed both in the creation box and the current 
display area. 

N(ext character) : selects the next character as the current 
character. 

T(ype) : selects between displaying the current character as a hires 
(h) or a multi-color (m) character. 

M(ove here) : asks for a character number. That character is copied 
into the current character. Note that this operation destroys the 
current character. 

CColor) : allows choice of colors. A cursor will appear at each of 
the color parameters in turn. Type the three latter abbreviation for 
the color of your choice for each register in turn. 

X(pand) : selects either 8 bit by 8 bit characters or 16 bit by 16 
bit characters. Answer YES or ND (or Y or N) to select expansion. 
When expansion is selected, four contiguous characters will be 
treated as a single entity for the purpose of all commands.' The 
creation box will be expanded. The characters are edited in the 
following format. . v 

1 3 

2 4 


F(ont) : masking function from the Commodore 64 POM. The program 
asks if you want to mask all the characters. Answering Y replaces 
the current character set with the upper case character set from 
RDM. If you answer N (or just hit RETURN), the program will ask for 
a character number (from 0 to 63). That character from ROM will be 
copied into the current character. 

P.(ange) : sets a range of characters for use with SAVE, LOAD, BYTE 
and DISPLAY commands. The form is ##:## (i.e. 0:12), for first and 
last characters to be affected.by an operation. 


are 


of 

of 


0(r) : like move, but doesn't erase the current character first 
A(ddress) : this command selects the assumed address of the character 
data. This is used when the characters are saved. if thev 

reloaded by a BASIC load command, that is where they will load ^ 
S(ave) : asks for a file name, then saves the current ranae 

characters to disk, as a program file using the assumed addrp^ 

L(oad) : asks for a file name, then loads the lurrSt See 

characters from disk into the work area from that n r oor=» m 
B(yte) : asks for a file name, then saves th/ Sr rent Mancie of 

^ Commodore ’ s 

Q(uit) : exits the program. 

V(alue) : displays the values of the bytes which make ud the current 
character. These values appear next in the chapter ^i=rJay area. 
This display lasts until any key is hit. ^ ^ “^Tdiracter 
display reapps ars * 

H(ex flag) : toggles whether the V(alue) 
or in hex. 

F3 : step through possible screen colors. 


display will be in decimal 
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EDITING COMMAND KEYS 

These commands operate on the current character in the creation box. 

1. * : places a dot at the current cursor position. 

2. SPACE BAR : places a space (removes a dot) from the current cursor 
position. 

3. CRSR RIGHT : moves the cursor one position to the right. 

4. CRSR LEFT : moves the cursor one position to the left. 

5. CRSR UP ; moves the cursor one line up. 

6. CRSR DOWN : moves the cursor one line down. 

7. RETURN : moves the cursor to the start of the current line. 

8. HDME : moves the cursor to the top left corner of the character. 

9. CLR : erases the current character. 

10. RVS : reverses the current character. 

11. INST : moves all dots on the current one place to the right. 

12. DEL : moves all dots on the current line one place to the left. 

13. + : moves all lines from the current line to the bottom line one line 
down. 

14. : moves all lines from the current line to the top line, one line 
up. 


BLK 

ORN 


COLOR OODES 


WHT 

RED 

CYN 

PUR 

GRN 

BLU 

YEL 

brn 

RD2 

GYl 

GY2 

GNl 

BL2’ 

GY3 
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USERS GUIDE 
FOR THE 

6356^6367 VIDEO INTERFACE CHIPS 


The 6366/S5S7 are multi-purpose color video controller d*wic»s Tor 
use in botn computer video terminals -and video game appl ications. Both 
devices contain 47 control registers which 4 r» accessed uU a standard 
3 -bit microprocessor bus <©3XX:> and will access up to ioX oT memory Tor 
display inTormation. The various operating modes and options within 
each mode are described. 

CHARACTER 01SPLAY MODE 

In the character display mode, the 6366y'S367 Tetches CHARACTER 
POINTERS Trom .he VIDEO MATRIX area oT memory and translates the 
pointe rs to character dot location addresses in the 2 , 8-43 byte- 
CHARACTER BASE area or memory. The video matrix is comprised oT 1,880 
consecutive locations in memory which each contain an eight *bit 
character pointer. The location oT the video matrix within, memory is 
defined by VM13-VrU8 in register 24 <S135 which are used as thv 4 * flS3 
oT the video matrix address. The lower order 18 bits are provided by 
an internal counter <VC3-VC35 which steps through the 1880 character 
locations. Note that the 5366/6357 provides 14 address outputs; 
There-Tore additional system hardware may be required Tor ccmpletv 
system memory decodes. 


CHARACTER POINTER AOCRE33 

A13 A12 All A13 A89 A8S A07 A86 A03 A04 A83 A82 A01 A08 

VM13 VM12 VM 11 Vflia VC3 VC3 VC7 VCS VC3 VC4 VC3 VC2 VC1 VC3 

The eight bit character pointer permits up to 236 dl-HHrent character 
deTinitiorts to- be available simultaneously. Each character is an 3 x 3 
dot matrix stored in the character base as eight consecutive bytes. 

The location oT the character base is de-Tined by C313—C311 also in 

regi^er 24 <d!35 which are used Tor The 3 most signiTcant bits <MS35 
oT the character base ac dress. The 11 lower order addresses are Termed 
by the 3 bit character pointer Trom the video matrix <07-035 which 

selects a perticluar character, and a 3 bit raster counter <RC2—RC 35 
which selects one oT tne eight, character bytes. The resulting 
characters are Tcrmated as 23 rows oT 48 characters each. In addition 
-o the 3 bit chanacter pointer, a 4_dit COLOR NY33LE is associated with 
each video matrix location < the video matrix memory must be. 12 bi-'- 

uiide) which deTines one oT sixteen colors Tor each character. 

CHARACTER OATA A00RE3S 

312 A12 All A18 A83 A83 A37 A 86 A83 A84 A 33 fll31 ^ 

0313 C312 C311 07 06 03 04 03 02 01 0 * *C2 RCi RQz~ 


PROPRIcTARV INFORMATION_C0MMC0QRS INTL 


13 MAY 1582 










o3©o?'S3©?' USERS •-JIDE 


•STANDARD CHARACTER MOOE 


<MCM 


BMM 


ECM 




In standard character mod*, the 3 sequential bytes iTcra the 

;~~-fehbr*actor base are displayed directly on 3 lines in each character 

£ r*« 3 i on . A ”3“ eit causes the b a ck ground #0 color <iTo™ 

-* register 33 <421) ) To be displayed while the color selected by the 
r.: color nybble < foreground) is oisplay-ea tor -a. 1 biT <—Color Cod* 

Tab-VaO. 


FUNCTION 

Background 
F oreg.-cund 


CHARACTER 

BIT 

a 

1 


COLOR 01SPLAYED 


Bac k gro u nd #0 color <register 23 <421)5 
Color- selected by 4-bit- color nybble 


There-for* , each character has a unique color determined by the +-bit 
color nybble- <1 os* IS) and all characters share the common background 
color. 


MULTICOLOR CHARACTER MOOE 


<MCM ml, 3MM * ECM 


0) 


. v 


i a -js . dr--Mu l Ti—color- mode gr-ouides additiona.1 color Ylexibility allowing up 
‘-T o '-hour' colors within each character- buT with reduced resolution. TH* 
multi -color mod* is selected by setting The- MCM bit i n regisrar 22 
;r<siS) to "1", -which causes-. the- dot- daTa stored- in the character base To 
-be int erpr eted in a di r -rerxrr t «ann*r. IT The* MSB of the color nybble 
is a “a - , Th»- character will b*- displayed as described in standard 
character mod*, allowing The- two modes to be inter-mixed <how*o*r, only 
the lower order 3 colory are available). When the MSB o-i» the color 
nybble is a “1" <ii* MCM. MSB <CM) = 1) the character bits are inter pre ted 
in The multi-color mode: 


FUNCTION 

8-ack *3 r*o un d 

ground 
: For*-3 round 
: For^3rcur.d 


CHARACTER 
BIT PAIR 

00 

81 

10 

il 


C OLO R OISPLRVED 



Color- specifi*d by 3 L3S of color nybble 


Since two bits are required to specify one dot color, * h>? character 

JL y- P. m-3.“^}'' 1 1C Hn-f j __ ^ Cn«iT-3lC, 


now-delayed as a 4 x 3 matrix with each dot twice the hcri-rtal r.re 
> ^ in standard mode. Note, howeoer, that each Character r^Ion --an now 
4 diYYerent colors, two « foreground and two «£cj£ound 

KS** nos priority)• 




:r*- 


r / c ; ^ rr 

' u ft 

**~:r ^* 
•if r£.«T 

v^DTf n . .&- 


-rruS-c f? 
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Bzi ;c?< sssess? -usesaSc-MUiOE 


EXTENDED COLOR MOOE 


r. • 


<E01 » 1, eMM « MCJ1 


>3) 


Th* extended color racd* allous dh* selection cd-^individual 
iaACicground colors •rtr **c .h chor-act^r r^jion usidh the- normal- ~ 3-. <r~x 3 
■ir.irsc -?r resolution. This mod* is selected by setting th* ECW b-i.d- od 
register 1? <iU) da "l". Th* character dod data is displayed-- as- in 
dh* standard, mod* <doreground color determined by the- color nyio'bl*' is 
diS7»l^y*d dor a. "I" data. bid?, hurt th* 2 nS3 od dh* character pointer 
ar*_us*d do select dh* background. color dor each character region as 


-f*ol loo«: 


CHAR POINTER 
MS SIT PAIR 

00 

01 

10 

11 


BACKGROUND COLOR DISPLAYED FOR 

Background #0-color <regist*r 33 
Background M color (register 34 <s 22 >;> T - 
Background #2 color (register 33 ~<*23 
Background #3 color (register 3 tS <S2A) >" 


Since dh* too MSB od dh* character pointers an* us*d"d^r '' cLl 
irrdormadion, only <54 didderent character dedinidiens are availabll 
Th» oioo^SSoT mill dorca C313 and C23 do "3“ regardless od dh*. origin.*! 
poindar values, so dhad only dh* dirst 54 characdar dadinidions <uiLl hi 
m-**s*d. With extended color mod* *aeh Characdar has- on* od -'- H- ,r^n 
individually d*din*d. foreground colors and on* od dh* -*our -u a n,ui 
background colors. 

NOTE — Extended color mod* and muIdi—color mod* 
should nod b* enablad simuldan*ously, 


BIT MAP MOOE 


In bid mar* mod*, dh* o3o©kS3o7' detches data drom memory in 
didderent dash ion, so dhad a on*—do—on* correspondence exisds b*»-t~. * 

each displayed do-t and a memory bid. Th* bid map mod* Pr — 
screen resoludicn od 323H x 233V individually ccnorolad display Z * A 
Bid map mod* is s*l*cdad by setting dh* BMM bid in register l t csin” 3 * 
a " 1 ". Th* VIDEO MATRIX is sdi 11 accessed as in. diaracoer,,, iede V^ 
dh* video matrix data is no long*r interpreted as character poin-e 
bud rather as color data. Th* VIDEO MATRIX COUNTER is nhan - also' 
as an address do dedch dh* ded data .dor display 
OTSPLAV BASE. Th* display bas* addr*ss is dome 


..-'-‘sed 


>y drom -dh* 3,333-,.! byt* 
*m*d as do.I Vows; , 

‘d c / 


A13 A12 All flia *33 *30 337 33 3 333 334 330 332 331 fliae 

C313 VC3 VC3 VCT VCE VC3 VC4 VC3VC2 VC1 VC3 RC2 RCx ^7^ 


VCx denodes dh* video matrix counter outputs, RCx denotes *h* 
raster lin* counter and C313 is drom register 24 <S13>. 3 . 

matrix counter steps through the same 43 locations dor ei-ah* '■’idem 

lines, continuing do dh* next 43 locations every eighth" l in«» v r ‘ ? - > "er 
ra-ater counter increments once dor' each horizontal video 1 ! " dh* 

l in*> • This addressing results in each eight seguent^i ‘''“aster 

♦'il rn»?morv 


?ROPFIETfl RV - rHFORWATION COMMOOORE INTL 


MAV , I4jsj> 


a ,&Z*i*''*** tr 


£***; * r • ££*****• • ;*,**«* ■*.. i 











locations being formatted as an 3x8 dot block on the video display, 
STRNORRQ BIT MRP MOPS- <8MM « 1, MCM - 0) 

When standard bit map mod* is in us*, the color info rm ation is 
d*rio*d only from the data stored in the video matrix <th* color nytoble- 
\s disregarded). The 3 bits are divided into two 4—bit nybbles which 
^l Icui two colors to be- indeperdentaly selected in each 8x8 dot block- 
When a bit in the display memory is a "0“ the- color of the output dot 
^jls set by the least si^nifiearrt (lower)- nybble (L8N). Similarly, a 
"display memory bit of "1“ selects the output color determined by the 
MSN <upper nybble). 


bit • oisplrv color 

0 louw nybble erf video matrix pointer 

I Upper nybble of* video matrix pointer 


MULTI-COLOR BIT MRP MQOE. (8MM » MCM - O 


Multi-colored bit ma*> rrode is selected by setting the 
register 22 <*18) to a n" in conjunction with the 

Multi-color mode uses the- .came memory access sequence as s 
map mod€>, but interprets the dot data as follows: 


MCT bit in 
BMM bit- 
tandard bit 


BIT PRIR 


OISPLRV COLOR 


00 

01 

10 

11 


3adZk><2r*o*jrtcL #0 color (register 23 <S2i>) 
Upper nybble cf video matrix pointer" 
Lower nybble of video matrix painter" 
Video- matrix, color nybble 


Note that the color nybble <0811-088) 13 used- for the 

map mode. Rgain, as two bits are used to select one’ 
horizontal dot size is doubled, resulting in a scre<*n 
180H x 200V. Utilising multi-color bit map mode,, fhr«< 
selected colors can be displayed in each 3 x 3 block in 
background color. 


fflulti—color bit 
dot color, the 
resolution of 
* independently 

addition to the 
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.r *. * £' r u z> ^ r- <r * * *: «. :rs jr>:.-, 


movable object blocks 


The movable- object block <MOS>. is .. a. speci al"" -gyp*.; oYcharacter 
which can be displayed art any one 'position on th* screen. .without -th* 
block constraints inherent in character and' bitmap ’ mode".'.'. "Up to " 3 
unigue MOBs can be displayed s imuitahecus ly, ' each de-fined by.. .£3 bytes 
in memory which an* displayed- as 1 24x21 dot .'array Csrioyjn ..jwVouO. ft 
number oY special Y»atures mak* 'W<?8s esi»*<a4't V^^i'-tecC ^ *$or video 
graphics and gam* applicators. ‘ ' *‘‘ 



c 


I 

1 

BYTE 1 

* SVTE 

1 BYTE 1 

1 

00 1 


1 '*‘”02 1 

i 

83 1 

• r 84 

1 "0‘5 1 

1 

I 

. 1 

‘ . 1 

• 

. 

L... J 

1 . r 

1 

r 

. 1 
37 * 1 

•* 

fnS »i 

wW 

1 . 1 : 

1 5sr 1 

f 

60 * 1 

61 ' 

r S2 1 . 

v., 


.. , 



MO 8 OISPLhY 3L0C< 

EHBBLc 

Each MOB can bp s«lactively enabled i*or display by setting 1 

corresponding enable bit <hn£5 to “1* in register 21 <S155. Iy the* 
bit is "8“, rtc M08 operations wi.ll occur* inuoluing th* disabled M 03 . 

POSITION 

Each MOB is position*d via. its X and V position register 
register- map^ with a resolution oY 312 hor icon-cal and 236 vertical 
positions. The position on* a MOB is determined by the upper— le-H ; 
comer oY the array. X locations Sr to 3 U .3 CS t^-siST) and V locations* 

30 to 243 <S22-SF3> are visible. Since not an available MOB positions 
are entirely visible on the screen, MOBs, may be sieved smoothly on and 
-the display screen . 

COLOR 

Each MOB has a seperare 4—bit register to determine -the MQ£ color 
The two MOB color modes are: 

3TPN0PR0 MOB <MnMC a 3) 

In -the standard mode, a “0" bit oY MOB da.tr, is allows a 
t^ground data to show through <transparent> and a "i” u it v 
displayed as the MOB color determined by the corresponding * Ml -f 
Color register. - nue 















MULTI-COLOR MOB 


<MnMC » 1) 


Ec'Ch M08 can Be T'neiTvidually sel-iC^ed as a. multi-color MOB via. 
MnnC bits in the.MOB Multi-color register 23 <siC). When the MnMC 
bit is "l"., the- corresponding~MOB is displayed in the multi-color 
mode. In the mufti color mod*, the MOB data is interpreted 
ir~s <simiiar to the- other multi-color modes) as -hollows: 


in 


FIT PflXH 


COLOR OISPLPYED 


__ Transparent 

: ~M0B Multi-color 3*3. <register 37 <003)) 

MUS Cdldr <registers 33-4<S <S27-S2£)) 

.MOB Multi-color #1 <register 33 <S23)) 

the resolution ot 
dot expanded to twice 

„ „ ..change. Note that 

up ' to '3 “ colors can be •• displayed in each MOB <m addition to 
transparent) but that two ot the colors are- shared among all the M083 
in the multi—color' mode. 



'MPGNIF I&RT I OH r 


. . . V ' 


_ Each MOB can be selectively expanded <2X) in both the hori-antal 

__ ^dj^^ical dzr+iz'ttcns* Hue ccn-tadn -fch* c 0 rrtr*ol 

" lei rfi* n^3ni-t*i c-art ion ccrvtrcir 


b i-fcs 


smo¬ 
te -to i 


RHSIGTHR 

23 <S10) 
23 <sl7) 


FUNCTION 


Horizontal expand MnXS - “ i •* ^expand; “9“ a nortnal 

Vertical expand HnVE - “t"-expand; "3"anormal 


When MOBs are expanded/, no increase 
«ame 24x21 array <12x21 ii* multi-col 


b*;; »•- 
' *r 
.j: . « 

Sit' 1 '. 

•drtr 

l*: “ “• i 


in resolution is reali-ed. The 
sane 24x21 array <12x21 it multi-colored) is displayed, bus the overall 
MOB dimension is doubled in the desired direction <the small-st MOB dot 
may be up to 4X standard dot dimension it a MOB is both multi-colored 
and expanded). rrc.- ~ 


priority 




The 

mcc 

o -f. r^i. 


priOhi^^. ^'^08 b, individually controled 

to the other displayed lntormation from charac- 
The priority **& M, 3 8 is set by the correspo 
—27 <S12^ « . rollews i 


vi-tin 

:-er* or* b i 
‘^spondin? bid: CMnOP> 


’' ‘REG BIT 


• 3C*r 


“priority to CHPRPCTcR or 2 IT nflP DPI FI 

' m;- 


Non-transparent .MOB .data Mill be displayed <1108 in front) 

"■ Ndn—Thansperent MOB data will be displayed only instead ot 
PUgd ' or mu 14“COlor .bit pair 31 <t 


<hOQ b-?hi ncO 
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Ti 


nndp >_ 1,. JT\ . .*Mfc<bf? 


La : u i.f 
,it: 


MOSrr , " JL por^.cjr^5und_^' I* 

Fcr^rcynd^^ jl r Mp8n _ ’. \‘\ .1 
Background I B-acic ground T *** 

MOB"— QISPLPV OPTfl PRIORITY 


. r..n+ - 

i «s , *1ht». ►* 

ti. •’* /. r 




M08 data. bits _ot "9“ in_ mwT^-^b.lor mode) are„ •tr > ansp*r*'»n-t, aluiays 

permitting wy other- i n formatigh ^o fee, displayed. 


The MOSs hay* a. fixed priority iiiith res p ect *to' each other. «ii-th 
nos d hawing the highest, pricrj t ^,.a^,Mgi| r 7_:fch*. Ipoest, -Wbofi^QOS data 
<#xc»p-t transparent dat^,. o^-. jao.SOfs an^ co r ihpjd*n^.". f rcm 

the lo«f*r number N08 wi VjU , bo J ^.iiifptaS'ifd^ _1 flOa ^ ys, ‘ _^pg d«ta 
prioritised before priority r^soli^ion >itri„cFiaract«r7br^bi''¥'sia J i : H - 


-— 1 ,w '-' T'’' ff *'■'5 --^y8^9«5a 

before priority resolution yith^cfrarac?*rTdr,. : n A ta _' 

COLLISION DETECTION 


Cwr ~ J. tv 


“JC 


, >or 


> un —"t- — 


Tiuo types -of M08 collision <co-incidence) are detected ,...mqb to MOe 
collision and n08 to display data, col l is ion: ‘' " l3 * i 

8 collision betmeen taw PtC8s occurs whennor>—^ran snaire t-i-t- output 
data, of taio M08s are- co—incident, t _ Co—Incidence of 1^3,8. 
areas-. i»iU not generate- a collision. When a collision occurs thi» 
nce bits <Mnrt) in ; _,$he* M0S-M08 COLLISION register 38 <SIE> mii{ 

**■* ^ *1“ tor both colliding-M 08 s. 8s a collision between 
<cr more) NC8s occurs, the M08-M08 collision bit for each collided 
n08 mill be set. The collision bits remaLin set until a read ot 
the collision register, ahen all bits are automatically cleared 
HOSs collisions are detected euen ii» positioned off-screen. 

Th * second type of collision is a M08-08T8 collision between a MOB 
and foreground display data from the character or bit map modes 
The M08—08T8 COLLISION register 31 <slF) has a bit <MnO) for each 
M 08 which is set to " 1 “ when both the ^08 and non-background 

display data are co-incident. Again, the co-incidence of only 
transparent data does not generate a collUfon. ror special 
app l icaticns, the display.data from ti^e 1 - mlJ ^ lO°Vor bit pair 
also does not cause a col lision. This. .+t&&n 9 f '* ^ 

^ ^^^^round display; d*X. a. uii-dnQu-s MOe 

collisions. 8 M08-08T8 col l fcjsioiV" can ^ o^CMf* ® An tn. 

Horizontal direction if actual'"display data has be 
OT l Y-7 , 3C7* t ?<; 


~ 1 ,J 1 “-screen position-Xsee jscrol ling; ~ 
register also automatical ly cl ea rs ^ —-*- 

.... «-rri 


ISP i ay ---. r • scroi Ved 

{.Ung^ ..JJ* noe-08TA c CQU.ISIQM 


Th 


r»ade 















MO8 MEMORV ACCESS 


_ . P?* 5***^ *£ ! ach M08 is in «3 consecutive bydes .o*. .memory. 

^locx ot* MOS dsta is dedined by -a. MQ8 pointer, located *3Efe "The »nd 


o-r* the VIDEO MATRIX 


Only 1,303 bytss o-r- the video matrix a/-e used in 
^■.t- Tfc|*-nprs*al disjeiay.-raod«s,v al-lowin^the uiceo matrix locations I 01 o -1033 
;> <VM base^s3F8.to..r.Vtt.feas*iws3^»^--- to-'^be used dor. riCE 0-7, 

rx rr*sn^^ivo3v., ' Thi»v.^ig} T .i bib M08- : r^in-i:an t>m» the video matrix together 
-.’•r^-w.iTh.. The six"*bits* dforfc the M03 % ; by-« ' counter <-t 0 ^dbnws o3 bytes5 
, v.nSte^iia** t.‘>* er<tir*'ri4~b'iV -add. .is dields "■. ■" 

P13 A12 All A10 A09 ’ AQS A07 A0<» A05 A04 


AOS A02 A01 AO0 


MCS 


MP7 MPC- .'RR3-' : MP4- MP3 ■ MP3 ttr- V 1 ' MP0* MC3 MC4 nc3 MC3 MCI 

Whcrer-MPsc c art,■-bb*>*MQS pointer bi ; -cf dro..r the video matrix and MCx 
The internally- sen#* -sited. MQ8 counter* bibs. The t-tOB pointers are read 
Trom the video matrix at the end od every raster line. When the V 
position register od a‘M08 matches The current r.asber- line count, the 
actual detches od MOS daba begin* Inbannal ccurvter^s a* ibomabical ly step-* 
e.~'through 53r-b¥>bb» Three by-Us ow raster 


ciJc-i-ne.- 

«••«?* 


£-‘\~ C'L—;>~r . 


i^rr * .v 

r-*e j. 


crrjt j. 


4 *; 

Sr*' 


‘n'-et SCREEN- PUANKIHG 




<r ' - ;< 


■GTHE.-N FEATURES 


The display screen may be btanked' by sebbing the OEM bib in 
register 17 CSX 15 to a ’*0". When the screen in blanked, the •ntire 
will be billed with th«.- exterior color as set * n register 33 
When blank in-3- is active, only transparent <?hase o memory 
a.-e. required, pemiittinfl prccesscr ut ili= ^ ion ^ ^ 

_So MOS daba, however, will be .aoces^eo ir the MQ&3 .are nob 

-also disabled,. The DSN bib must Be *** *« L Tor normal video- 

-display. 


m l^T, 


*rl? 

*L, r,. 



* * “ ^'srt^ta bu^o 




ROtVCOLUHN SELECT 

Th* ncrm-al disp^^y cort^i: 
r^ion^J P**~ " 


, const*** 2? ** 4 * 

rotfle For 5P^-i al d 1573lav Purpo^s, th* 
^24 roius and 30 characters. ? n, r , ' ia n< 

, _i t neior^ltAtl OH r ^CSpt 


•aindc»u m^vy b^ r^eciuc^ 

i m -u__ ^_> 


< or 

-- rn^vy rwu»-^- — - excspt . — I'CU'T 

border . rThecseUcb bvts operate as _ 




R2 


EL 


Number 


(3 ^ roM^ 


I 


gg- hlUalWl " '*•>*• columns 


0 

l 


24 rows 

25 rows 


0 

3- l'- - 


23 columns 
columns 


• U 
l ZZ 


^ V -- 

---- .T'<«ir iW the CSEL bid i 3 ir> _ 

Jhe < Rsa. flrt1r ^»sth bh'e -1Teri»'*:-;<!V spl fY . is normal l 

5 ^-or-standaro di^ . ui/ ^ o , 0 - is■-norma l ly ^js^rj - in CO njuncbio 

•v'j»ed>-. mhide the- -snatH^- *** s ";.. .. ,^1 

•rd^xbh scroi-loh , 5»5 : e ru. ~' r - z r ‘ : ~' 


y 
'ion 


PROPRIETARV information 


commooors ihtl 


13 MAV 13:32 
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, *■• c V ■“-'T •- 

'Th*L^i£sp lay m data may b^.rsqrtoiUl^d. 


*.*v 


G*>r, - 

;Vrv 


■r, ,1m c 


1 v* rt>i ,■ 

Xi!Vv *?c 

...._ !JUP: 2»-''J»n*’fserrt-iPrf d-iSnSc-tfcp sjo*c* 

in.. bpj-th : tfck» .horiscrrftal . ; -arwfcr v^f^Ssa^vtdlr^cTiasn.c r >TWhi»rr-~‘ u£«d in 
conjuH^io^Juii'th. "th*- sm*H«r~ «$*«*&»' ^ti o c te w H *SaboO»> ,. send ITIrt^-'c-an b<» 
■us*d to sr»^,t* » .3Me^.i^i^jM^sin <©•*•• ctisj^l-ay itertau- r «>|!»l?t#n:. 

--Sh* memory only uihwrv, •** <’©r ^CiiTTSmrO i s 

r-*<VJir*d. Scrolling is also us*d -to c*n-t»r a. i*ix*d dis?»laiy >ni-thin -th* 
diSPl-ax suindoui. _ . , He , t - 0 * esc. B&- * ;f .-. if-. i- rf ’ ~.P 


BITS 


I* 


ssorsrrsp ~<?«i r-". ^*. k .FuaeT.iofif c :r, 


„X2,Xl,Xa i_. 
v^,v.i,vq i'.. 


ZZ-<stp) c -jvc^.jse Wori*3n-tatb;P<KSr'i'-S4-epf-- 
.. 17" 43T4-1J>< = - g--i i.^rY^f'WiCa.UBoart^idri 


LIGHT PEN 


■ -^ re- tXT* r.,7 *.i-s fji.- (n.:jv s-rc rr~ 

vH? 4r».*iw«w SOPl'it -t> ~«ra.;pf -. r.: :r ,'ict, 
SC:" vt o-r 


. i tr-’Kr. , ?.'$**** 3.. : • » w y;vr^.7 «r J 

TfigP*n input JLa-g^«..^t^,cwcrr?n=t «scr > e*»f£c' position-^ 
pair of-' i egisters <LPX#LPV> on a low—going edge. The X^nadsitioiv 
r^ist^r 15* <^13> will con-tain -the 3 HSS of -the X position at The ^ 
of transition. * 

position is latched in i^s-raegis^per*'but here 3 bits provide 
single ras-:«r resolution within -the visible disp-lay. The Vight Pn , 
latch may be* triggered only once per frames and ^bs^^verr£3,Trigo^2 
within -the* same -rename will. have- no ehftc 

w - .- • Vvi..-r e-~ 

RASTER REGISTER 




The- raster register is a dual 4jncTion register. R read 
raster .register 13 <s'l^ returns -the lower 3 bits of tir curr^-t 
positon <the MS3—RC3 is located in register 17 <sil>>. The •ri»^ >r 

register can be interrogated to implement display changes outside 
‘•'i^ikle area to prevent display flicker. The visible display windoi • * 
from raster ZQ through raster 2W <si«3-s^F3^. fl write to the r3 ^. 1S 
bits < including RC3^ is latched for use in an internal raster comp-arT^ 
When the current raster matches the written valu*?, the raster intef-ZT^l 
Utth U„irt. ■- ... rnrerv; v£ i •* - vr*, ■ Uf3i: 


INTERRUPT REGISTER 


r . % > - ' { ~ . tur* ,r 

^ i ’ V:. - r TJ »r- »: c:r r.>f. * J « 

7ne interrupt register shows., the status of ^ -tour. soi^a s 
interr^jpt, Rn Interrupt ..latch ^n register % is tSet to-^ivt.. • fU 

an internet source has "generated "an interrupt 
sources of ^interrupf are : r-- 


an 


$ 


v^c 


reguea 


The 


,XJ hen 

tour 


latch 

bit 


ENABLE . . 

bit. ^ 
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THEOP.V OF OPERATION 


SYSTEM INTERFACE 
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Th^ a3oo^E3b<. uid^o contr^oller deuic« interact 
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d*a»t-^ bu^. in . a. syt^t^in^.r*^<^uir*'^c^uir* t ?s tb* 01 

busses only during, thg^pjnase'2 ,Ccigcic high> portion ot-She cycle. * ~The 
55oo/ , 'S5«7 , ..;dev.ices 5^ake ^ advant^^y- ; ot this ._ feature by. normal ly "accessing 
system memory during th?-Phase • 1 <clCCV« ...lowportion ...o-r 1 the "cTocic 
cycle. Theretore> operations such as character data -fetches m emorv 

re-fresh are total ly transparent to the processor and do -not reduce 
processor througn—put. Tne viaeo chips provide the interface -j, I 
s.i.gjna.ls, r .ceg.ui/^ed tq_ntain.-ib-i.is bus snaring, 
v * v> rr -v. 

t 3 f* »*l t- J 1 A ^ 1 hS f ^ __ . 
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^2 
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<*13:> 
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<*ia> 
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<*28> 
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nOORSSS 
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C?v ^ 
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0S6e;5'C083 BC0S4 

083 

— 

25- . - 

£082 

rEC • 
J-E3 

Sfft 
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DESCRIPTION 

00 

<^SS) 

nox7 

MSXo 1-21SX5 £0iaX4 

noxa 

940X2 

MlSXl 

n0*3 

noe 

0 

X-Po^i*tion 

01 

<S0O 

M0V7 

navi? s3iavs srnev^' 

M0V3 

cMSV-2 

M^I 

nova 

nos 

0 

Y-po^i-tion 

02 

<*02> 

M1X7 

M1X<5.; M11X5 -^011X4 

M1X3 

"M1X2 

ffiSKi 

mxa 

nos 

1 

X-posi-tion 

03 

<s*33} 

nvr? 

M1V«S:&«11V5 C-M1V4 

niV3 

-M'1V2 

v hrv-i 

niV0 

(108 

1 

Y-po^i-fcicn 

04 

<^04 ) 

H2X7 

M2XE —M2X3 „:M2X4 

M2X3 

W2X2 

M2X1 

M2X0 

nos 

2 

X-posi-tion 

03 


M2V7 

M2Vi3TS.W2V5 .. -T12V4 

M2V3 

£(12 V2 

M3SC1 

n2V0 

noB 


Y-posli;ion 

06 

<^06> 

M3>f7. 

M2XS-f-M2X5 S 312X4 

n3X3 

M2>«2 

M2X'l 

n3>{0 

nos 

w 

X-pcsi-feion 

07 

<3%7-> 


M3Vait-W3V5 -'LM3V4 

n3V3 

at3V2 

M2VT 

M3VQ 

nos 

3 

Y-posii:ion 

03 

CiO 3^ 


M4XS-& M4X3' 6214X4 

M4X3 

W4X2 

M45tl 

n4xa 

noe 

4 

X-posii:ion 

05 

<^05> 

M4M7- 

M4VS; .:-«4V5 ,: :314V4 

n4V3 

•M4V2 

'W4V.1 

n4Y0 

nos 

4 

Y-p03fi*tion 

10 


^3X7 

M5X«,-.£W3XS 6315X4 

n^<3 

$15X2 

M«5>^1 

M5X0 

nos 

5 

X-posi-tion 

11 


n?V7 

M5Y>S; i-'-M5V5 5B5V4 

n3V3 

M5V2 

MSSft 

nsYa 

nos 

3 

Y-po^il:lon 

12 


M.6X7; 

MEXfiy'/MEXS *£1EX4 

n6X3 

WSX2 

ME^ri 

n6xa 

nos 

6 

X-po^i-feion 

13 

<^0O) 

n6Y7 

M«Vo;.* MEV3. 6BEY4 

M6V3 

BSV2 

mEV-i 

M6Y0 

nos 

6 

Y-po*i*ticn 

14 

csoe:* 

n7X7 

M7XE>-M7X5 1E17X4 

n7X3 

tirx2 

mTXI 

nTXQ 

nos 


X-pc^i*tlon 

13 

ISZF') 

M7Y7 

M7V<S;~ J M7V5 1J17V4 

M7V3 

M7V-2 


n7Y8 

no8 

•* 

Y-posi*tion 

16 

<^10> 

n7X3 

MSX3 M5X3—344X3—*13X3—M£X3 

M1X3 

nexe 

nsa 

o-f X-pcsiTion 

17 


RC3 

SCI SMM DEN 

RSEL. 

V2 

VI , 

Y0 



13 

<^12^ 

RC7 

RCS RC3‘ ■-RKSe^D 

v RCT3: c 

RS2 S- 

RC1 

Rea 

Rastan r^3isn;«n 

15 

<*i3:> 

LPX3 

l—°X7 LPXE LPX3 

LPX4 

LPX3 

LPX2 

LPXl 

Ligh*t 

P^n X 


M7S 


M6E 


M2H H4£ M2E • M2S 

Z ~ RES CSEL, X2 

M6YE M3YS M4VE M2VE n2VE 

VM13 VM12 VM11— Vfl-ie- G313-~G3*2 


IRQ 


ILP 

ELP 


innc 

Ettnc 


*• w0' ; « -*- 

J17DP fUSDPiiflsoP .«40P M30P M2DP 

MrMC MSMCeSHShG' r M4(1C M3MC M2MC 

m-C*" M65< S-' i W®<S c«4XE M3X£ W2XE 

« . M nesM ; M5M .., y-[4 M 

fTSD 1 M50 .(140 


mtm 

mto 


(13P1 

M30 

EC3 


. iLPVi^'UPVQ 
niE nee 

xi xa 
mi vs msye 
C311 

ih$S irst 
em6c erst 

Ml-QP MSOP 
M tn'G M0MC 

ni&£ msxe 


nai- 

M20 - 
SC 2 - 


- t: - 


CV- — < 

A..*, 


? 

-f - .,1. 

. .1 


38C3 30C2- 

31C3 E1C2- 

32C3 22 C2 

33C3 32C2 

MM03 (1(102 
MPU3 MM 12- 
MS C2 MBC2- 
M1C3 M-1C2 
M2C2 M2C2- 
M3C3 M3C2- 
M4C3 M4C2- 
M3C3 M3C2- 
-MEC3—M6G2 


M1M - 
MID S 
EC-1- 
SSCl- 
3iei- 


MSM 

MSO 

sea 

3SC3 

sica 


S2C !"■ 32 CS 
22Cl= 32C3 

Mmi" MMSS 
■Wh4.ll- MMlS 

riser- neca 
Ml'Cl' Mica 
M2S1 C M2Ca 
M2C1- M3CS 


M4Cl c 

M5G1 

MSC1 


M4ca 

M5C3 

Mejca 


M7C1 M7ca 


MOTS: A 


M7C3 M7C2 

indict 4 ™ conn^s ^ ~*d «, * 


Ligh-t P*n V 
*riOQ Enable 

M08 Y—♦xpartd 
fl9(nory Poirrt*ns 
Irrtarr*up - c R«i: 
Enable Irrb#rrup-t 
nOB-CRTfl Pricri-ty 
nos nutricolor Cal 
n08 X—?xpand 
n08-il08 Collision 
nOB-ORTR Collision 
Ex^arlor Colon 
SU'gd *0 Colon 
3Uyd *1 Colon 
2Ucjd 42 Colon 
SUejd 43 Colon 
noe nul tlco Ion 40 
n08 nul^icolon 4L 
n08 0 Colon 
n08 1 Colon 
nos 2 Colon 
nos 2 Colon 
noe 4 Colon 
n08 3 Colon 
n08 6 Colon 
. nOS 7 Colon 
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-RfCOWOOORE ..urns'-' ^ £i. FqC ‘ r '’ 13 MflV l5t2£ 
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65S1 Sound Interface Device (SID) 
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mm 1 . »■ unUT.i 


.‘r-i vr~ 




4£i* 


4 ~ . - : J. - r « - r v ,...•. . V _<M v ..- 

*.--%*r f ^ -•" - i,. -- 
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i ’k^mifcrnn 


CONCERT 


•'•■* :*.••£ t* ‘ * 1 ®?^/' * f \Ty^^srfi!*»*****■ ♦■**.•?t § £ 


-*'***Jm-■ lW'i 


•.»■; 5 = ~VL 



EATURE? 


3 TONE OSCILLATORS 

Ram**: 0—4. kHz 

4 WAVEFORMS PER OSCILLATOR 

Tr iang 1 * , S*aMrfcooTh> 

V»ri*.to T* Pu l?-?,. No i:?*? 

3 AMPLITUDE MODULATORS 
R^*n««a j 43 dB 
3 ENVELOPE GENERATORS 
£xpon*rvti* l r*spons* 

A**5*fciucS< R^/t^*: ZmS^SS 
Q*C*y R-s-.Ta s 6aiS-24S 
3u&"£«&in L*m* 1: O—mo lum* 
1**25* RcTt : 6mS-24S 

OSCILLATOR synghronI 2 flf ion 

RINp mOOULflfION 
PRO-ORfiMPlftBL~ rILTcP. 

Cu-fco-pif r?ri ^. 30 h =-12 1 <H= 

12 ^e/octjw* Ac 1 lo-H 5 
Uow r** 3s , e*nd pws, 

Hi-?h p~_=-=- r Notch outputs 

1 * R**on*nc* 

" *VOLUME CONTROL 
* i=LD POT ;n T r P ro r r.c 

RANDOM NUnw^^T I ON OPERATOR 
“"'' ~~ N|i|1 ” AI.1QXo Jnrijt 


1 PIN COHFXnnppTION 


CAP 1 A 
CAP IB 
CAP2A 
C PP2S 
P.EB 
02 
P.,-~ 
C3 
AO 
A 1 
A2 
AS 
A4 
GND 


w 26 
4^-^:=! 12 S 
’• SlO 24 


■s 

a 

10 

11 

12 

1 *t* 

14 


21 

20 

13 

18 

17 

15 


Veto 

AUOI0 OUT 
ET : <T IN 

?OT X 
POT v 
07 
05 
0 ? 

04 

03 

02 

01 

00 


a 


V 31 





,.',• . j* ■ w— 3 l •'■/j&Jiiict 


v.4-. i> •liSififctoAs 
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u^d indrP*nd*nt ly or in -ionjunction : i.yi*iih Vs*ifi 'ot?h*r" 
audio •lO'.rcr-r/ vO ':r*i.r« 


•'.' Or -r.x^frrva \ 

_ ^ 

I-Emo4 : tc>f#. *r)%^ 


a. Tens Orel V latsor. ■’W*vs > ^^f , m 0 
an (nfnp li“uda r-lodu la.tor. .Tip.* Tp, 
ot* tha woiir ovar a. wida 
wa.va-fcrms a.t tha sa 
COntant o-f aach w«.w*-fortn 

7h* mo lum* dynamic* o-f rth*'!osci«Vl*!tbrf• 

•*mr-Vs^ad* * Modia-la.tor^uhdar'-^ orro? - r -^a'-'SFn~aT^ 

i&S-^Sov.* l*tSL*. J3*gM>aMi>g»onKffl«!i»^**^ 
with pro*r*mm*b la ri.^s o-f incraesin-? and dacraasin* mo luma. 

In addition to tha thr** voicas, a. programmab la "i Itar is providad 


• h s : 


•l*ct*d rraouat^, liiiftihartnonic 

a-form pr«Midirtg^*W^\^-'!?c«&rHr41' o*f -tori* color. ljsek«r" 


■for 


vr# 


.tin>3 CQmp-lax 


2?i- .\- 


^dyn*m_i*; .-ton*,^a^®rai»vi-K.i^ijs^r^^y* fxgtyge>#i*v 


; ! 


i 




SID allows tha microprocessor to raa.d tha chanpin« output 

.Of -W^jaiibt: Q?SJL,U*-$?.r JQSL^?.4S^ l^Xix***. 

ouisuts...can .-ba^scaad---** --a. souro.a.^otf-modutV^icT^irrformarts^jr,-- -p^r 
craa.ting vibrato, -f ra<tuancy.'-f i Itar swaaps and similar- e-f-f*cts. 

Tha third oscS 11 la.tor can *.-1*0 act-a* a-randorn -hj,.*n*-h^.%Or. ; -BV 

-for 9*m**. ** TwOisfl^'O conM^htars-ara 7»ro\>t:dacf -for 'Ihtar^ *c¥tW ; ?ID : i 

with potantibmatars;• ■ Th***- canv b* usad.-for “r*«:id t*** *i>rt"isc- ^-ama ...y V-■>*'••;>»# 

environment or *s -front pana-V- centre Is -.-in- V r music“-s:,-r,-!;h''asii'aKi ; - - ~ -;A> 

SID can procass-axtarna. 1 audio. si-?h*.ls>- a.inowing -mu It-ip t^iTD:* 

chip*-to ba" daisy—cha.inad or mi-xad r in comp:lax po lyphonic sy-rtafhS.V.- ? 

_ ____ _ ^ ^ nV-C 

">*•' - *^r. * u . vtk jsnrs, :r3r 

- -• --« .v ..^w.VJ-S 
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■ 
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f ‘ .* , 
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•* ' \ •-• 5 • • , 
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; . -v- A ? f !? ? 
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/> • . >.• * . 


f.:;”'---’ . -c : P. -“'.---> 


r . • • ■■•• - 

_,:v 

• - ' ~. r >r . . r .;• 

v-w-I.-ef-.- -v, 

tvtfe*' 1 j'-j- Tt- i '- , . i '‘ 3 ^»a*f r ^.. "v" - 

- # •'• •>%* ! .v4 * L * 

■ .--/• . • • ' ' 

- ‘ - ■ -•i-'-c;:-- -x-' 

: ' .v ■ - 

• ^/‘•-‘•v.. #•, "c -v.,1 • -. : 

U . ?; ,, : - • -1- • • V^.-- 

- '•■'• '.s 

. w .7. &&asssa%rTz 
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POTY PO^K tHT IN 

6581 SID BLOCK OlftQRfll-t 
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SID CONTROL • R-nISTERS 


Ther« *r* w 23.-*i.gthT-bj «t 




04 

sound. 

Tl 

Kes 

e re^isTe 

lirT-?d 

be 

low 

in 

Teb le 1. 





/ 

c 

!v ■' 



POOREST 


REG 


A4 

PS, 

A^> 

PS—so- 

“<he:>< 

0 


0 

0 

0 


00 

1 

•0 

0 

0 

0 

—r 

— OT “ 


0 

0 

0 

1 

^0 

02 

W 

0 

0 

0 

i 

1 

i. 

03 

4 

0 

0 

1, 

0 

•0 

04. 


0 

0 

1 

0 

1 , 

05 


0 

0 

. 1 

1 

0 

08' 







•s : 

- r 

• 0 

0 

1 

1 

1 

07- 

8 

0 

1 

0 

0 

0 

03 

o 

0 

1 

0 

0 

1 

03 

:r 10 

0 

1 

0 

1 

0 - 

■ — 0A 

if ii 

0 

1 

0 

1 

1. 

0S 

12 

0 

1 

1 

0 

0 

0C 

. 13 


A 

1 

! ^ 


00 — 


- 


•• 


• ^ 

: i' 

14 

0 

1 

1 

1 

0 

0E • 

15; 

_ 

r ” 

1 

1 

1 

1 , 

0F 

lo- 

1 . 

0 

0 

0 

0 

10 

17 

1 

0 

0 

0 

1 

11 

13 

1 

0 

0 

1 

0 

12 

IQ 

1 

0 

0 

1 

1 

13 

.20 

1 

0 

1 

0 

0 

14 

21 

1 

0 

1 

0 

~1 e - 

15 

‘T'O 

1 

0 f 

r 

1 

0 

16 


1 

0 

i 

1 

1? 

. 17 

24 

1 

1 

0 

0 

0'.. 

13 


1 

1 

0 

0 


< 

s. 13 

2* 

1 

1 

0 

1 

.-0. L, 

.X4A - 

•^*7 

1 

1 

0 

1 

1 ' 

. 13 


1 

1 

1 

*0- 

-•0 

■ nTc*- 


r ’ e *^ 1 ~7ers in SID which contro 1 *the cienersiTion 
R *i^her WRITE-on ly or REAQ-on ly..end *r* 

I '*i r* 5 


_DATA_ _ 

07~ 0S ^D5 'D4'nS5 D2 D1 ~D0 


l?f l?a IF3.IF. .urTTpy 

IP>tt IFrj I Fta I rn IFm IF* I F ~ 


^>7tp»4ipyripwi.;ipw^|pw ? |pw, irw<> 


--'I I - I — IPW»F*.»IPV*lfy« 


>^»nn.l^vT I^a frgTlSfegl.rryclgsrg 


tfTr^/n-Sai^rr, i/nXa'acvipqraUcr, ixr. 




gg.j p « I r« P^IFalFf IFq I ARE 


F/51 Fh* 1 Fry 1 Ft 2* \ Fr/cj F;a ip^jra 




~ RBfk-.-sssz!} 

NAME 

•■,^,— ^vCQTCE 1 
-FREQ LO 
rRtS HI 
PW LCG; ' 

PW H IE 
CONTROL. PEG 

p^povdecpy 

-jSiSTp. I H/RELEPSE 
VOICE 2 
FREQ sLO 
rREO -MJ 

-Efcfc’Ltfr i i .: ! 

pw i he : , 

CONTROL PEG 
PTTPOC/OECPY 
SUSTPlNr'RSLEPSE 
* > VOICE 3 

.PREG- LO / 

FPEQ HI 
PW LO 
PW HI 

CONTROL REG 

__. PTTPCKXPECPY 

ST^|j7ViJSTy,|ST)4iAa^»gd^sW>glS«| - S1JT7AIN,'RELEPSE 

FILTER 
FC LO 




jgjeifuii^vi rati 


/Ftdffnhl *rg,lffn^l», )t<r« 


r }ynwsT><dsTvjS7HgR^Ms,fes, i5s3 ,. 


F? F<, Fy 1 Fa. Fa iFt 

Fi 

Fo 

£ty1FjttlrSl FralRi IR. 

F-s 

Fs 

F wh p)Y«jp >vsi prra i p V3f Pr/t 

PN,| 

IPV« 

— | — | — I — | pm,IPa»*. 

PV»I 


»*~dDJllAA 

'^TKHT»ry>=raj5«=r' t |PCXi 


““-I —-j-~ i- — I ~ IF^sIFSh IFCJ 


F:/.lP<nlPC» IFCtIFL IF^y IRfi 


3»*H HP | ST .1 LP IVbtalv»LtFou l*»c 


f££j; 

BH |H»cJ 


PX^tRX^ PXgJWC»ffX»iFXaJPXi IFXa 


0?iO<,lQg lo+lOTlOalOi LOJ 

giTSd'er IS4l5.7lSa.lg; Ie> 


FC HI. c 
RES/'Fll’T 
MOOE^V^L 
It ; ftfsCr 
•' POTX - « " 
TPOW®'••“ 
OSCSt'-PRNQOM: 

J5HU3_ 


l" i 


REG 

TYPE 

WRITE-on Is- 
WRITS-on l> 
WRITE-on h■ 
. M ..WRITE-on !;• 
^WR:ITE-or« l> 
WRITE—on \> 
(|* W RITE—on 1 v 

?URITE-on l> 
* WRITE—on*ly 
".WRITE—pn \y 
IWEJTE-ort ly 
■-WRlI^E—on Iv 
•WRTfe-or. \y 
= WRX^- i cn ly 

...WRITE-on ly 
WRITE—on ly 
WRITE—on ly 
WRIi&—only 
WRITE-on ly 
WRITE—on Vy 
WRITE—on ly 

WRITE—on I*..* 
WRITE-on \i 
WRITE—on lO 
WRITE-on \ y 

RSPO-on Iv 
RSflO-on Iv 

RSPO-on I-', 
RSPO-on I*;.* 


TABLE 1 ~^''fP'~RSG I'-ETER MAP 

. M'it ?^TT 

cj w. ' ir ~5? : 

-• & <• 4 F> .r r >- 

c 


« 

z £ 


c c 
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- ^3L*r:. ; 









































































v A.y-I^.r„. L'C i‘.‘i t . 

_ ^ C- <_ . . •- ~ 

' % V* i"0' .'O’* .'—. 

>. '• -V‘*>v •, '---V iiv. -* -.*• •:»- v -V- 


• V^teg r^^ ' -- - 

•BcmenaaEaB „ 

> gg-S'T! ^i;r?gy$Tr'- A^Is**Hf **_, zip ,K^ - 


iontrc Is 



' •'.'. tvr,' ."• '. ' ■ F ° l -rt - /<r n,,# G^7?£>_H= -,-- . f — -,C~ 

^ ..«•». >^»r * >*•£ . £. ^7^")* * n- r .7 " 1 . *“*: ~ •Z-» - •■ v *S‘ • • ^'Vr* - 'T i. 

R com?5 V*jtAj : 3 • *c - v*.v«&;S o-f \y— 

mCf5l -ia. I ~ s££ 1 * wi’tft conc?r^ R <443 Hr) tuning is ^in 

^r>*fndi*x R• I*t should b*? no’t^d "th-j/t *tho> fr?«uency r^o lution o4 SID 
is siu-rfi'Zixrrt *o r t ^nygainst. sc&le^a.nd \o^s r: siK^^ir^ .from ^nct» -to net-? 
-Vith “no 'jiis*z^rr)ii6. 1*, .fr^^uvney fvi?P'5. ,. -v-.t,*; 




x * r 1 . 


PUJ LQSPU HI tRjryi ri:?rV '9'2..33 V - 

T.:.^*-!:h-3-r .T'?rm /iumb*sr.,j:bits. 4-7■ '■?■?_ PW HI =•/-■? not 

u**d> 35v», u .r!w l**- WicjlSt' <du*y iyc tJhsc Pu Is* 

».<*.v*-fof“M on -Oscijl'l-srtoH 1,. Tbof„ p.uls* jwi.d"tfcy.-is- d*~*r*ivii.r>*d b>*1 \o<"in^ 
.tuition: / •-* ' " ~ ' '*" 


u. f. — —■ r.**-—»>- o.j'j' • jr. 7 — *- ^ _ •?• -i^nc ^ C* - 

- p •; .'.:: , _ ch^u* •. -. .<pwpx*©-« 55 > w .^* -.. 

1 <' •• •- w * = ‘" ' *’ • . " 1 * ' * , * 

. PUrr l ! i'~Vh* 12-bi4^numte-r* .in -th*. P.u Is* Wid-fch r*«j.isH;*rs. 



contpol pS(5t?t^p ".rp*..-.i-s~hiA e.4 

4l_ _ - V • ' I „ I 1 1 - • ' i i . 


V>0* :• - 


eus os**t i on.- 



pr*-f*rii 5 V.-- i.-m.*r ■?*■>■»■> Tr*n..j*n-i:.-' c-r r, -.. • * '." 7h-an : 

NO ««Sh*r o-^ Voio* 3 h*v* Wy l - 

^ - • •/ on rvp'i« 


41- n. ' 






. V . ~dizl 






















Piyroo ■'Si'* - th. rihc wo i,Tt. ,« «. , 

Irur ' 9li ’ weve-rorm output ot Osci,l le.tor 1 with * "Rin<a m.-.hu 

comtein^/ticn o+ Osci 1 U.torj - -- * * u 

Osci 1 Is^/tor* 

.- Oi* 1 ncn^h^TTnori i 

5Cf«QndS &Tid ' -tor i «■. V . 

i to j r i «&noi \& 


l or. aop*'. 

In order tor r?-p.« .jmod^i^tiorf-1£::: 
i o+ use: l U.tor. 1 mus^b b* - \ic^-=-c< 


* ^ 1 .**;?_ to soffie treguenev other thin --_ r 

H, O-WT- f>*rMh*t*r3 ofV S tc»-3 hiO* WVw,« «, bin,ilSdClSlcn. 



fr™.«r |rt 11 DC NcrMlly bi- 

is used tor .estmg purposes; however, ' i't cen be used " 
synchronise Oscillator 1 to e^rn*l events, *l losing t? 

^enerstiort ot hi*Kly comp lex '^e¥ornfis‘Ohdeh reet^^rV 
.con-tro ti“ c ' ?.. ■"-.' ••.-•■ -- t-i . «• •:—..-ftt;. v, T^^-ct^ttiwererv. ~ 

. VT- o C O'**' *pi? :.t^r c**.-r v - '«•* l- r-m r ; ,"S 

A/V(5it »tv,-.^ -nhgn set *o i-'orte T'^e" TriWig le M ^ev^or n ;'' •“•-.* ... 

usci l l*.tor 1 is se-lec^.:^W^i^^'«?iiv^r'm is •’gT^ ^rC'. v 
hemronacs end hes e. mellow, t lute- like .AU-Mitv. 1 ln 

‘h 1 t . ^2 When set to-'e, one/ the 'feewtooth 


Oscrr 1 fetor 
*K*+r\- and odd 


_ __vV. .. •>* _ 

WWert *** “«''*• one / the 'Sewtobth"'V*w/_u.lr '• : ' 

I **'*m*if. : > TH* SWtbotfl iueueVorm*T- V 
d hermonxes-.en'-d his ^bright, bressV 

~ 1 w * 1‘ '*’ ’’ i ®*t to e. one, the. Pulse mavtto^ ... 

usci 1 le.tor 1 is selected.—Th- iT-’/ cLT° r ™ <= "- r t» a ut ot 


nn 
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U * 1 ? 1 ? changes e.t the frequency ot Osci. 1 le.tor l. ^ 1 <?n '"''^ 
noT-t^* • ^* n ** *. Jgw .rv wft n lfw » .H earing’••? 

in * ?i *'"*'* ’0»C'i 1 Victor -f Frequency registers. *2.* 

fxplosion^, aiunzho^cz p J^-5 €>ncjin--^, n»ir>H " 1 l5 -'. u ^*ru 1 *. •; 
til2i Un ' Si1SCh * d sounds, es well es snere drums end rl-'^t ' 

' . ng-*ne osci 1’le.tdr-’ treguency with 'Noise se ter taw ' ~' 

» drame^j^ r«j»hirtg **+f*c*. ' v ' * ‘ -^^uces 

.•: .- *• / rv ^ .J x • fc rf- - —- * .'•'r*' - . s' v » r Cbfch- -V 

CH»“ rsi .~* T • - Ti 'T“ ' .. . Z.' 


he*audi-bvl , * i *ve-tornfi^‘rnurt" be 'selected" tor- Os'iii l'iVton i' 

!Tl^i -thI ^ i* 'N©T necessery-to dese fect' w^etn l? ^ 

'2r->-„ u x ■ i~ -output ot •Vdi'eiTI';” The’eflin litucie ot Voice *i V* rn,s: 

.OVtP ^ » tunctiem ot^Envelope Oeneretor only/" " ' T 1 * 1 * tin^l 

. ; 0^1*5 *• " “ * " •••* 
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B 1 +.?. *4—7 o*r ?nii CflTK©—^TK35 1§C* 1 •HP 16 ATTACK nr-T**.? 

SriM* l*p* .Oeri^r^.or . Th^ fijTTcjCK - rs.7* ; .->•♦*»». r =■/* i cl lv 

- r a.v*~i /.. f i *i i,^i . - i - (OJE , 


7h* Vci-ie 
7h* o»j7pQ 7 ; o-f 
^nfcrS&or 
5. - - 

7h~ OECrlV eye U fc VlOM.'S thr 
ns-pidly 7h* cutout 7-r.l Is 


vn«t v OlCf 1 iHM*r LOP* ■• -ri^r-r. r~t I H n J HVfi. . f„ ■?• •■•■*’ ; vTr. ♦‘-■•.v. r r/- 

outpUT ' Of ■ Voice r risesfrom'. peak, . *J»p.j ituda' whejv -The. Enve lo. 

-ti : 'G£i*'*y The" lO^tRCk. r*5W"*r~. listed ba,!©^ 4*v T,»fc.i* 2. 

? i -x <?-h ^D^’Vij-dcVsV 1 ■ of 1® DECAY ref as for the Enve lope 0e< 
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flTTRCK eye l* *nd 7he 
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G*n*r r.T-o-r 
DECriV r r.7«r d*t*rrr* i n~”S h-O'.u 

7o 7h* s* l*c7~d 3US7f»IN l**,'•=■ ’.. 
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*-7 ©f mis 


The 15 OSCflV . .._ r ,« . ... - - ... - . 

-. ? ^.; *^r-r : “>C ■ • - • • * ^ - 

22} _ r f V " - i ■ 

________ ._ r**istarTSTNO-STNS> se lect 1 or 15 SUSTAIN leva \s 

r -n» Enu* Vafsn* .ij-snsr'i.-tof*.' " Th»- S©£TAIR'•«?€*♦ th* PEC3V eye If *nd 

•ry-bp.u-!;. .j-f :'i6ai'cs--I «.**' th*'' s* SUSTAIN «i»f» Vi'^ajd* \ork« •*&. «h* 

ft *■♦■=■ bi't r*nca.tn»= ar^*tv-:Th* SUSTfll'N kvels rsn?* -ft-om rer-o to r>*-sO< imp 1 i-tud* in 
— n<i-t;h i -SUSTAIN u-9.lu* O-f <3 s* l*ctin«i sjro -iinn lii-.ud-^ ind 

*" A*'SOSTAUrc,*.iue 


Gi.t-i 

15 liriiir J1;*(S>S. ivi*h *. SUSTAIN ■-■-?.lu-> o-f <3 s* l*cisinoi =?r - 

%.-.SyStai.N .«fc4vi*«.^i.3 _«»m^Utaud*. .. -- 

3 would .5*^**-Voi-«*-1--torSWSTfflN «t «n on-*^h«.t? "%h*“»>**k 

*"•* b^'-th* ATTACK-:c;--c \*r ■ "* v. -•• •“ _ 

5-.i-T.s- CRLSpgAUSS'j- s- 3 -1*^*5 1 ’OT' 15 REl_EASc ri.t« -for' ^h* Env-j. lon-i 
'f*p*r.vzctr. ..,.,Th«..gELS@SS cyc-\*- -Pc-Vlows The SUSTAIN eye \* whin 

Time... Th* ouTruT p-p Volo* .1 ^ - 1 --- 


■ . ..,..•- _-. VJ -._ _ ___ .. biT 

is r*rs>-„\< To..zeeo.' this. Ti.m*.«. Th* ouTruT o-P Voio* .1 wiVr^i.lt -Pr-om TH* 

SUSTAIN ^imfa.liTyd* To seno.. S'/n^liTud* -^T- The:'5'J i^TAd RELEASE r’sJT*. ' The 15 

RELEASE rites ere 'identical "to The OECAV r*T«. 
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NOTE: The o-cUng o-p the Envelope OenereTor .ren be elTered 
vi * The Oe.be biT. Th- E.nue lone Oenere.Tor cen be Oehed end 
Released withouT r-^rinbion. For e.vo/«R l*>" i* The O-e.te mb' is reset 
before ..the envelop-, h s finished The ATTACK cycle, the RELEASE 
cycle will r™edi*.t*.ly begin, s^erTing from whatever 
been re*.ihe.d. je *he envelope is Then oe.ved <..ge^n .... 

The RELEASE cycle has reached sero ampUTude^, another ATTACK cycle 
will begin, starting from whatever a/np litude had been ■ 

This technique can be used To generate comp ex 
y i ■*• tea.l-Time software contro l« 
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<0> 

1 

Cl> 

2 

<2> 

3 

C3> 

4 

• Uj- 

5 

^ 3> 

6 

<6> 

7 

C7> 

3 

<3> 

? .*' 

o> 

10 


11 
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F.-v-i- 0, —~C*0 contro 1 Voice 2 end e«re *f unc*tie.\ V-* i.den“*i»- «►- 

rr‘?irt.*rr 00-0* wi-Sh -fch exceptions: * * 

a.— - : : - “ -. V. ■-•••.• r - ■*•!?-~x -- •' -i -r- 



• Roisters *©£-#14 control Voice 3 indVs furtcti^U'^.^ntirM 1 ” ~ 

registers ®@-®€ with these exceptions: S \^z *"*%%\ 


"il£ M 9P r-W%U***».*h*- Tri*^«.d*-:-9utPwt Ot-.0®ii 

YO " 1 ’■:!?. • h -,.r i h3 w^u U.t*d cwnbine-ti^r. of--©sci Ue:tcrs~ ®-_ end ,£v-~ -vc'^'^.r 

i yt> i cal. fP*r.e.tion p-f e. y.pi,ce....consists -o-f : se 4ectth<i the-*■=•*■ i r~d >V'• 

C ?' CSVNC, -RING MOO? end .enOe lope rates I‘c : *CV *.? r 

/' h I '“T' voice whenever the sound is .desired. * -The > sound -*•>,.=• ■- “ ••«..*1 

SL * U unTr IT-? w*2: ? h ' ; °* ttw, « * rtd ^minated^bytclesrin* i •* 

* r .;?,S » *ir»«l*v W« U 1 UK*, 0 i** '■ 

* * l *'* h *' '•Uf.ing p-f each psci'l latpr-or“ tun in<< tr» -mi)•*•!,#* v'i*^.c. •."‘ n; * - ”- 
e. rich, an inverted sound. 
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v .the SuowTn^'ijuI.tio^’ ^ * wro * i »* t * Cutott Fre^ueniy^*^*"** 
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a ned 


FCout = < <o.5E-S 

Where FCn is the 11—bit number 
o-f the 
For the 


FCn * 1.28E-8>,'C> Hr 


r-:/‘r“; t" c »» 

’ *”'* re *-ornmend^d czr-’+.d tor o-p *- irn2p 

ion: FiU * r iS 3C1 ^ 


1-4. 
rin9* 


rCouir 


<3S 


FCn ' 5. S> Hz: 


I- ? r ’=‘ c iuencx r^riqe o-F f.he 
-c , / :< p liei'.'t! i onz^. 

in-Forru-r.-tion. 


.... Fi H*r c^r, b« -hr, -.,,- 4 . 

Refer to the Pin Description secti ©k '' ro J£J Cif 1 « 

?c 


^»r 

3ft 


F i Iter, 


Pg^./r ILT CF‘g-c* j ^r-hc. r xi 7^ • - , v * ,. 

C‘ 1 — O-t* X — r-.* .. • 1 . .A • _ _ A. s • f» .’ C • 

r esoner,ce ii e. Peekin,'!!^ S 'h“ ^ control the Resonance ^ + . 

Tne Cutott Frequency Ih lj! JiTli? jre^uency 

Se«onence settings r*n<«in-'v 1 '*7' c®u*ing e. sharper sour lfl . r vT| * ®t 

<■?-, "Sing Uneerly from.no resonance <e? tr. „ Sr ^ . . 

i 2 5 ^ ^ ^ 

d *'" Wn * »‘CK ^ rOM^d L, 

J l h T Uffi w . * a . . ‘ * Fl '^ = 

-b*r c.UCilO 

When set-to • - '* 

the Fi'ftV ^ - -~v. 

accordina ~ " 3 herrfion-i c- conte.n* ot Vo-iCe » •" ?‘:^Pr 

" •• ■-“‘i ^he .xe lected F i Iter. parameters. . - 1 " 1 .'1 ‘I v . 

• . :T - = • ■ ■• ■ , • - —• > -■ - 


* ,• F ‘Hfr, 

7o <•. zero. Voice 1 5p»i*frr r j 
-id th* r Fi l-hyer ,h« no e-h-^* c ^ ^ 1 ly - + 

Voice- 1 - i.yicl 1 be ^rocer^d +^ r ' •'“' 

I**, trmnri i «• - r» r*i r-. r,^~ A,'a^ •— «. C'l J r i L ■• 
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PILT 3 


- « bit: 0 ter Voic* 3. 


'-Sit 3> - S«sjii* *£ bit: 0 for Extern*. 1 *.udio input: <nin 25 >. 

r 10 0 £/VC 1 L CP*<«i r** n, . ? 18> , ~ ~ •* " •' “• 

‘•~~.~3its •*'~'~ *&is j3wi#!i*ri .** l**t Fi'i-s^ j,^ >d cl .rt W( t w tj W! 

-.. i_^ <'■ id Ken s*;t>o~.A cario. :th*. Ubu» Pass output •-*** p,- 

is ** lecH^.-^jd d3Utput,* : * TSF •* “ 3 1 v«-n Fi lt»r 

infers signal, *.11 +r*^u«ncy components be low th- Fi Iter r u t^ 

F Z*^*ZZ~ r: unaltered, while m-Wwwcy'components 

*bc«j- the Cut©,tf- *re- attenuated At- a r»t» <?-e 12 dB^Octav- Th* 
Low Pass mo* produces fuU-bodied rounds. 

X M&J Lj**?,...** Wt-4 . top,, the-Band Pass cutout. an fr-«uencv 


■I gy - fr S**t...** bit-4. gPF r Sh*-.e*ncJ Pass output. ail fluency 
. 7 #*>F b*l©Wr$h* Cutoff Jro attenuated 1+ ? 9; 

...,_17./ rt &*jzf r $ dB,rO?t*u9,.,. r Tb? . Bind - Pws mode produces thin ^ o r >h 

' " '** ' •••> ••• - : --•••■ 
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SE 1 t r 


HP <fS’i-s r *5~ - ”S«wn» 4cs biT. 

---a.li; - 


- — ■ rr. - -> - * or *he Hiofh P?« outputr- ft W^tr^qu^ncv 

components Atooue ...the Cutoff Are jessed unaltered. whi l»*U 


~ K. . r ir I o 
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' M -* r ’ 3- "■?p r r : - 

► •*■ r>.T" , -o**-^*! 

1 ^ »>v 


rr.v-*? ' ~ - r-~-.-s-v4 u*hi *11 

trepuency components be lout the Cutoff Art ■! 1-**. 

«* ;i2_.de^pcAAUS-.The .Hi-gih Pass mode produces h"~ ' 

sounds. ... ... ... .... ,.,.. — .. •• n»‘-' 

y *5? V *« %rv *Z • * • • < 


y: *• - *inT • * — # * /1 * • * * 

~~ Wh*n. t ,s:*T. Tp *. ont, Th* out?>ut o-f 



undMirjble output. More information on modu*1 -tf« WX *' 

can be -found in Appendix C. * ® n *' T * (i ects 
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iT aliens Th* <?*n*r*.Tion oT comp Ux Ton* co Vr- P 

■ ■ “ ’ Vvaf' sub tr act i 


n A 


€^limin*.T*-- ■' 

-trom a. hArmonicAl ly-rich input si ?n«U. The b **e tr *^*ncy componen -.-- 
bVOervihd...the. Cuto^,Fn*<weri«>-i.n ree-l-time. 'f.'L2w SU liJ - s 4r * **hieued 
Fi lte’r APpeers . in-Appendix C.c- 'h* 1 * - - — ' 


T ; discussion ot 
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Bit^^^yoLgryO^^j^iec-e 4;.of ouereM Vo lum- , • 

corffposite Audao Output^ _„.The output UO lurr.e leve Is r-j-,' ’•‘cr the tin*l 

maximum uo lumi^lJ or-in. lo linear steps. Thit*-T*'T? m no output <0> ‘ so 
a. static^Volume., contiToi,.for balancing levels in i»u'*i‘ u 1 Ci,ri b< * u3!4,d *~ 
cr*sting dvnemi.S volume Affects, such as Tremolo ‘*1 or for 

then =&ro must be se lected in order tor SID to pnod' * V ° lum * l^e l other 

uce Any sound. 
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PQTX < r? 4*^ i S l ft > - ” 

• his; n<r‘c* i^“T^r *.I lows? hhe microprocessor "to r -r mr _-..n— 

P I . 172 -ii* Cinr, *“** r i? ° POT\ **«..pin .24; • ulihh ; v-svVu« r«!r><^i*nci trorn—fr- ~.g . h‘~Trftnirnurri 

'rsri^.^nc©., ho tzz <;sFr> *.t r»i-sis^,c$. Th~ v*lu* '*l'n*v* 

iLi - 512 02 -clo^ cycles." • £ee'tl w Fl' iM b WgF iption 

-*c,xon tor int.ormi.tion- ..on PCt. end 'c^ssnijr xT-sUdiis"-* *' 


Unr - - 

r-e\ , lO * 5 * 1 


rr *. \:r\^ 
<r c* .. •• 


POTV < Rgoj ~+-»r JlRQ — i . ..,• L .„^^ - • *>. ..* ; lr *> v-v: 

es POTX for the pot tiled to POTV" <r>ln 23>. 

v - • . -1 ~ •:*C»r»T 

OSC S.-'RHHQQH _ 

bits’oi^n-JTiTiL *i low » 'W'* microprocessor'*& re^^Ae-'.^PS?H-^~outPut 
l TZ 3 * Th# S* ^ ndrnbers.senereted is 

0 4 Osci llltii* • !° 7 C 'I*' S-wt^ot^ /w*v*torm 

L „C^irb t 15 f* 1 **^' register «.i U pro«ntL«ri« 

4h* tr^CincC^^n' 7? T™ * 255 <SFF ^ ** * ret* determined by 

_. . *^' J '' nc> o^-Osci ll*tor 3. It the Tri dna 1 a 11121 — a ii . 



numerous . , -- ' -?«ri«r€.-5gr tor ot^r.^s. Ih«or« 3 * 

the chi-t S ’tunc*iL d ir‘*’riin C i7 9 WplicAtlons +or ~ h * OSC 3 register ^ however. 
The number* U deneret»d £°S£! y ^ h *V* * mod-il^Vbn ,,ntr^T— 
OscilUtor oi Filter s-lo,u£rr 91 ^f r “' . b# «*ci*d,;ui* software, to the 

r-*l-time „Li ! ■ • -s-^uency resistors or the Pu Ise’Width’registers in 

sounds c*A b- c-^JLTbv JZ ™ n ~ **Q* rart * d •*** menner. Siren-like' 

control ot eAothii' ' d ^,*‘ bdln ' 2 ' * h * osc 3 Sewtooth output, to the -rre^uenc'-- » 
prodCced^v^HH ffCiU A tor. $ynth«:=er '-Semple end .Ho Id“ ettects cen to- 
re-gisterx." JiLCL * °Jf 3 Noi;S * output to the Filter Frt^encx control 

eround 7 H= Z—*'??* ** S *^ in ^ ° £Ci 11 *^ 3 * putney 

Frequency contra^ rJdln< 3 OSC 3 Triengl# output <u>ith proper scelingj to the 

eCITl^te °* * nc * bh * r oscillator. ftn unlimited renoe ot ejects tr- 

p , n -Frequency ot OscilUtor 3 end sc*lin^ the OSC 

0 ^j. + v wh * n 0sci H*tor 3 is used ror modulation, the eudio 

output or Voice 3 should be eliminated <3 OFF-O. 
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FPeoi ftfr’ si r*< - 


01 re 1, bu T * hi;? ^isT-sr «1 lows the microprocessor to reed -he 

-he Fil--r - vC ’ 1C4, 3 Enve lope Generatort'* 1 ’ This' output esn be edded to 
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0"f "the Fi Iter ij: cjiuen by: 


w . .... ‘r-r.ch other., rne.Tch^d 

Th- frwu^Hcy rwg- of the Filter c-n h^'^i 

choice ot capacitor values. fL ^ “*" * J 

rf^uir* -full fvi-gh—frequency 

end C2 ecu Id be chosen 
■f the Fi lt*r. Th- 


'•’‘swns*. 
To provide 


*xemp l*. 

In this 
more contro 1 


maximum Cutoff Frep u *no 
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rCmay » 2. oE-3yC 

or •.-.... : t . ..~T r- .■ v £ .* 

Wh-r- C -is' the -<«P*:itor value. The ranq- * h>a Fi 1 + .„ _ 

? octaves tee-low the Mximum Cutoff Fr-^y.ncx. * 1 ' *•'--ends 


T* r T*** fe «nTr*ol for SID. 


When brought 


io... f dr “at' least Ten 02 cxciis," „ Uh * r 

s-nd The' r»xj‘d fro output is silenced. This pin is norm* l L .- ^nnl-L.s = ' 
line o-f the microprocessor on a power—on—c lee/* circuit* “Fie reset 


3^:-<P:in •?> - This TTL- lev-1 input is the master clock tor «iq 
frequencies end envelope rates an- referenced to thi-* c lork * 
controls date, trensfers between Sid end the micropr^^-sCC * — _ 

.only be Transferred when 92 is hio, h . Essential ly, «£ Htx*^ Thi^ 
ihip select as ter es data tranfers ere concerned.' ^h" Jin is ESS?* 
onnected To The system clock, with * nominal operating frequency of 'u 

PyuT CPin 72 - This TTL-* level input centre Is The direction of dete. 
between 310 end the microprocessor. If the chip select conditions hev'I 
been met, e. high on this line el lows the microprocessor to Reed de.te"frn« 
“the- 5*3- l*s-ct»d CIO re«2ii:rTer ^nd ^ low <«.llo‘»s The (nicroforocersor Uo Ur i+a. " ' 
de.Te. inTo th* selecTed SID r^irt^r, This pin i^r normally conn*ct*d tn 


R * 1 osci 1 l^ort 
32 *. l^o 


MHz. 


the ^-’crTem Feed/WriTe line. 


CS rPin 


-to 

5. < 


is lOW . 
r.ddr^^ 
y^ra o 


?% - This TTL- leve 1 inpu-t is **. 
conTrc L d-3*.t<i Trc-rrrer-r between SID r-nd 
low -Pre-rn The 

occur i-c IT3* i^-now, 02 15 hi^in end F/ET 
SID r*c,i 5 ^r • W only 'occur i * 

Pin ijfrAOf^fftA-VIV conhecTed 
To reside in. Th-f^memory‘ o*K 

- k ». , 

(Pin., t_ 1 e*, - These TTL- lev- l 

enough 

e -c- *,-rr s. o t • -- 

Of 

Fi Uirite 

de.te.. These pins 
lines of The mic 
wenner es memory. 


low active chip select ...hh-** 
the microprocessor. i^T 
se lected SID registerT 
is high. ft Write to the 


$2 is high end R,-~ , 
de-coding circuitry, ^ 


^U3*T be 
^•h o n i x 

s*? le-zTed 


low. 
allowing SID 


inruti 

t-ddre^jef 


e/-e U5*d 


t^? select n n ^ 
provided -d 


. “• ‘.-’“I*-' 

< P1ns ?—13 

SID registers. 'P Ithough - - - » 

registers. The reme_ining -hre- register locations 
To any o-f These Three locations is ignored end « 

normally connected To The correpnnn/: 1 n 

The.T 3ID may be addressed" iJ*’**ss 


<*/-e 




o-f The 
^ lecT 1 
n °T ust^-d. 

i nue. 1 i d 


2-r/ii-r 






_ If- “or best resu 

ipp ly snou Id be seper ete 
as will minimize digit* 


esv ITS/ The ground line . 

from ground lines To other ,s* 10 rri 
l noi^* « e.udio output. 351 '-i 


r/-,d The 
rcu i Tr # -' 


power 


la 


. * , 





























>-07 fpj ns 17* 22 j - These b i d i recti one. At ri i nes are uj*d to vr?nrf*r data 
•TtiiAAfi SID and the nucroproci^or^V' ^TH><?’^F4‘TTUT‘comp-i*.tib in the 
.out mode end capeb 1* o-f driving 2 7TL loads in The output mod*. The 
—-r. buff*r*5 are usuaI ly in The hlghr— impedanceott-r7*7*• During? c^t-- 


,r ite operation, the. data. butters remeTrn *in*; The'"btt ~^'ih put 7'~st^e...'en d~the ..." 
roproc*sror supplies data, to SID ov*r these; lines. ? Sur? i na* **•?* t ^ -.'i; .1 

" '**r .-1 on, the data, butters turn on arid SID supplias data.-. To-the micro— r.. .c 
..cesser over these linos. The pins, are norm a. I ly .connected -rto the- -.»* ~o.-v?~ 

:*rresponding data, lines ot tha microprocessor.. . • ^ • : .r -- t 

*.. . v '. . r '; T 'r"'*'- 1 : * . :^:; r ***. ”L z -'. T: nr» - ' :•«*« 

t’! - PC TV CPins 2- . ?t-. - Thase pins are inputs to tha R/'D donyerters -used 
:• digiti—e tha posiTion oT potentiometers. Tha conversion process is • 
s-sad on the time constant o-r a. capacitor tied -from tha : P0T .pin ...to-/ ^ 

-ound . charged by a. potantiomater tied -from the POT pin to vo lTs. : .~v..-/r .. 

•ia component ve.lues are datarminad by: ...... *. ^... t 

PC - 4.7E-4 

Where R is tha maximum resistance o-f tha pot and C is the capacitor. 

Tha larger tha capacitor., the smaller the POT value jitter. , 

The recommended ve.lues -for R and C are 470 KOhms and 1000 pF. - •- 

Note that a. separata pot and cap are required tor. each POT pin. 

c-Pjr - Rs with tha OHD line, a. separate +5 VDC line 5hcu Id. be “run-— ; '^ r “ 

etween SID Vcc and the power supp ly in order to minimice noise.- -R bypass r 
rpacitor should be located close to tha *in. ‘ w . ^ ’ 


:.-;T IN vPin 2*> - This ana.log input allows externa.l audio signals to be -mi^edT- 
i oh the audio output o-f SID or processed through the Filter. Typical ™'v7 M !“T777 
i-urces include voice, guitar and organ. The input impedance o-f this pin* i -s*-~ 
^ tha order o-f 180 KOhms. Rny signal applied direct ly to the pin should rid**? 

. e. DC level o-f S volts and should not exceed 3 volts p-p. In order to 
ant any inte-Ference caused by DC level di-f-ferences, external signals 
^ u Id be RC-coup led to EXT IN by an electrolytic capacitor in the 1-1*0 ur 
:-ng*. ** ‘Th* direct audio path <FILTEX-0> has unity gain, EXT IN c*n~be - - 

=ed to mix outputs *o-f many SID chips by daisy-chaining. The number ot'chip-* 
i.it can be chained in this manner is determined by the amount o-f noise and 

istortion a. llowable a.t the -fina.l output. Note that the output Volume . 

:ntrol will a-f-fect not on ly tha three SID voices, but also any external ~ . 


npu* 


rrom huuiq OUT to ground is required tor proper operation, 

.-,e recommended resistance is 1 UOhm -for a. standard cut put impedanceRs< 
output o-r SID rides at a. o volt DC level, it should be RC—coup led to - 
>Tr - audio amp litier with an electrolytic capacitor in the 1 —10 ur range. 


-Id /pjn — Rs ,oii:h Vcc, 

Vdd end a. bypass 


separate -^12 VDC line should be 
rpacitor shou Id be used. n»--- -• 






rlj 



•> w v . 'C*** *-^ ^* 






a*.. 




















65S1 SID CHARACTERISTICS 

ABSOLUT* MAXIMUM RATINOS 
RATINO 

■:u^p lv Vo iT-ag* 

Supp \y Vo It:.*/?* 

Input Vo lt*oie <! 2 >r\*. log j 
Input V© lnj*.ge {digit*. 12 

OpyriTinq T^mp-TAtur^ 

STor-aig* Temperature 



COMMENT 

Si. es^es aoove mose listed under “Absolute Maximum 
ratings may cause oermanen? carnage to :ne aevice. 
'••*se are st’ess ratings onty. Functional ooeration of mis 
cevice at tnesc or any otnef ccncirio^s aoove tncse mdr 
catec m :ne coeraiionai sections of rrts specification is not 
>mcneo anc-exocsure 10 aosofute maximum rating conar 
•>ons for extenoeo oenccsr .may Effect cevice renaowry. 


mi. incurs contain CfOte—ion 

to r;g n sate Oiscnarges ^‘'Vteoaveoicanac. 
oreventwneMva^a aoi?c-S * sn ^‘o o# Mercs'* 
aiiowaoi- | c 


symbol 

VALUE 

UNIT: 

•Jdd 

-3.3 To ml 7 

voc 

Vcc 

-3.3 To 

VDC 

Vina 

-3. 3 To m i 7 

voc 

Vind 

—*3*3 To i-7 

voc 

T* L 

0 To +73 

# c 

T^Tg 

-53 To mi 30 

# c 


'v 




Li. _v 
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syw 

—j 

Rh 
( T «— 1 

AO-A4 

. mm i 

1 xz 

cS 

“\\\\w\ 

H- 


j *TVo IjTiNM | 

Do-07 

~ n —i 

-JC 


*~Tw is 

MEfl5UR£I 
FROM ~TH£ 

u^res-r 

OCCUR!OF 

i^;C5j Rlw 


I «.M 

T'.'.tT 


U4r 1 T-* r' 

Uiri 


Z ,J Ul 

H 1 ? ic< T i rri*■=» 


WIN 


TVP 


WAX 


UNITS 


• r 4 
n *n ;r 




i rn 




^I i fn- 


0 


I 


nj 

n> 


« in*!*; 


7 »..••:* 


Chi p u, - 

7 " | ~ • H».« 1 r{ i iff, a 

•• =*• 11 »:< Q =.^.s. —-- 


10 


n>. 


Tdh 


n:« 


h^uTtIT^ 


1 0 


ns 


"1 

H 
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• s > ' 































































































APPENDIX A ~ EQUAL-TEMPERED MUSICAL SCALE VALUES 


1 N* t* l lowing t.*to I* lists th* nnm^< - • < . 

* h ‘ s ' T ID °' r '- i 1 1*-T*r fr*<iu$r,.;y control r*-zi 4.4- k !j!T~,2’. .'*~ h r, ’" J -* b * ^or~d in 

"* v * **"**inim, 12 s*mit*n*s (not«> ; c .n cVn *-~ l * **n*i*tr or 

-r T s<urn-:v-- o-f i ton* is w *i.. T-»Zu 

~«v,«. mtC. ni’,*; rr: ~ *' 

R *~*r TO th* tuition •jti^n in th- n"'^ ° n 

Clock ^**^«*n*i.*. Th^sc*!* wUc^icfil o?n.;ir^J I i ^- h ’ i '' r 


Hhr. 

clock fr*ciij*n'ii *s . 

A4 - 440 Hr. Transpositions o-P this sc* 1* 
T*m***r*d scis.1* fr-? -».l^o possibl*. 


■hrid 


*«* th* 

*n 

V2: > ^ i rri~s th* 

* *2 clock o-f i.e; 

US* Ot Oth-r 

i n »/.»h i ch 


__, ~ x r i «/.«n i cn 

n - r tf-1-n th* *<iu55.1- 



KOSl^M- 

P££C2. 

0 SC F„ 

os c f 


/OoTE 

CttO 


Cftex) 

n 

C0 

11 ?. 35 

263 

0 1 00 

l 

CO# 

1 r' • 32 

4 

01 ID 

4 

00 

IS. 35 

302 

012E 

•“; 

00# 

IS. 45 

320 

01 40 

4 

E0 

23 . 60 

333 

0 1 53 

5 

F0 

21. S3 

353 

0167 

6 

F0# 

23. 12 

380 

017C 

•7 

1 

00 

24 . 50 

403 

0 19.3 

O 

00# 

25 • S6 

427 

01 AS 

0 

R0 

27.50 

452 

01C 4 

10 

R0# 

23. 14 

473 

010F 

1 1 

BO 

3Q.87 

508 

01FC 

12 

Cl 

32. 70 

533 

021A 

13 

Cl# 

34,65 

570 

92SA 

14 

01 

36. 71 

604 

025C 

15 

01# 

38. S3 

640 

0280 

16 

El 

41.20 

673 

02A6 

17 

Fl 

43. 65 

713 

02 CE 

IS 

Fl# 

46. 25 

761 

82F9 

19 

Cl 

49. 00 

306 

8826 

20 

G1 # 

51.91 

854 

0856 

21 

Hi 

55. 00 

90S 

0889 

22 

HI# 

58. 27 

358 

03BE 

23 

B1 

61.74 

1 0 15 

03F7 

24 

1-. >, 

’-•Cl 

65.41 

1076 

0434 

25 

02# 

6S. 30 

1 140 

0474 

26 

02 

73. 42 

1200 

0488 

4 %' 
28 

02# 

E2 

T T» -7,-, 

• i* • r O 

82 . 41 

1273 

1355 

04FF 

054B 

23 

F2 

87 . 31 

1 436 

059C 

3© 

F2# 

92. 50 

1521 

05F1 

31 

32 

02 

02# 

98.00 

1 S3.83 

1612 

1 708 

064 C 

06AC 

33 

R2 

110.00 

180*3 

071 1 

34 

R2# 

116.54 

1317 : ; - 

0770 

•'S 

B2 

123.47 

2031 

07EF 

36 

37 

03 

03# 

130.31 

1 38 . 53 

2152 

2230 

0868 

08E8 

38 

03 

146.83 

24 15 

096F 

33 

03# 

135.56 

2553 

89FF 

40 

E3 

184 . 8 1 

271 1 

0R97 







41 

F3 

174.61 

2872 

42 

F3# 

135. 00 

3043 

43 

* G3 

136. 00 

3224 

44 

03# 

207.65 

3416 

45 

R3 

220.09 

3613 

46 

R3# 

233.08 

3834 

47 

83 

246.34 

4062 

48 

C4 

261.63 

4303 

43 

C4# 

277.18 

4553 

50 

04 

233.66 

4830 

51 

□4# 

311. 13 

5117 

52 

E4 

323.63 

5422 

53 

F4 

343.23 

5744 

54 

F4# 

363.33 

6086 

55 

G4 

332.00 

6448 

56 

G4# 

415.30 

6831 

57 

R4 

440.00 

7237 

58 

R4# 

466.16 

7668 

53 

84 

433 .88 

8124 

60 

C5 

523.25 

8607 

61 

C5# 

554.37 

3118 

62 

05 

587.33 

3661 • 

63 

054 

622.25 

10235 

64 

E5 

653.26 

10844 

65 

F5 

633.46 

11488 

66 

F5# 

733.33 

1 21 72 

67 

G5 

783.33 

12335 

68 

G5# 

830.61 

13662 

63 

R5 

880 .00 

14474 

70 

R5# 

332•33 

15335 

71 

85 

387.77 

16247 

72 

C 6 

1046.50 

17213 

r •-* 

C 6 # 

1108.73 

18237 

74 

06 

1174.66 

13321 

75 

064 

4 244.51 

20470 

76 

E 6 

318.51 

21637 

r* »* 

F 6 

1336.31 

22377 

r" 'I* 

F64 

1473.38 

24343 

70 

G 6 

1567.38 

25731 

30 

G64 

1661.22 

27324 


SI 

*4 

35 

36 

37 

.••O 

.33 

O0 

•?1 
O; •; 

^4 


RS 
R 6 # 
86 
C7 
C7# 
□ 7 
07# 
£7 
F7 
F74 
07 
07# 
R 7 
R7# 
87 


1760.00 
1864.66 
1375.58 
2038.00 
2217.46 


28343 
80670 
32434 
34426 
364 78 


0833 

08 E 3 

3C38 

0058 

0E23 

0EFR 

0FDE 

10CF 

1 1 OF 

12DE 

13FD 

152E 

1679 

17C6 

1339 

1RRF 

1C 45 

IDF 4 

1FBC 

213F 

233E 

2580 

27FB 

2R5C 

2CE0 

2FSC 

325F 

355E 

333R 

3BE7 

3F77 

4330 

4730 

4873 

4FF6 

5487 

53 Cl 

5F17 

64GF 

6 RBC 

7115 

77CE 

7EEE 

367R 

SE79 


343.32 

33642 

?€F2 


433.02 

40340 

•?FEC 


:637.02 

4 3374 

fiSEE 


733.S3 

45354 

6:3:32 


■ 053 .36 

43686 

BE2E 


135.36 

5 1531 

C"370 


:322. 44 

54643 

057? 

. 

:520.0O. 

57338 

E22R 

■ 

•723.31 

6 1 34 1 

EF'30 


1351.07 

64335 

F'QOC 












rl l^hOU*?h vhr Ir* prov i d— “ - •ir.-.r* 1 a - -j ; . 

"f- h * r*.u*.l-t*mp*r*d scale, it i* M*r^ «*m.srv' iA-Vir^ .-*<^* d "' : ' r ** n * r ** i ''* 
*y**s ter th* t*bt* a ion*. *ttici*f,,- ... ,:' , i - ?; * ;;: ; •' : -'- flr - 5 

no-?* vs.lu* Alciori-fchmic&l ly. Us in* **i . ^ cte-Serminin* 

***^-'r **■!* +r-Hu^ncy ot that not* in tA* n -Vt l " *'*' ; " r 

look-up table can b* reduced -from So entries *,-, ,o 1/ ~ .’' ! * v * 

li notes per octave. It the 12 entri« <2-i b«+«" -,-A-i —’* ~ n * r * -'** 

tor th* eighth octave <C7 through B7>, th*n not*^' in* ln,..I r ' w * lu * 

derived by choosing th* «>propri*.t* not* in th- lior-H* , '*'‘ V '' 5S ' lsn b * 

toi*? v*. lu* toy iwo ■for* -j^.chj Mt^^otdit^^yr ^7i, *™ r «^*z* 
is noth l ng nr, or* than a right-shitt ot th* valu-. the .- A i,-i% by "'" ,:u 

b* wtorap lished by * simp l* sottwar* rout in-. fl ithn "iT can *-a*i ly 

r*rg* ot th* Oscillators, this value should sti 11 £l in.-w/"' x f b - yond ~ h * 
rorcalculation Purposes <th* MSS ot B7 would r*«uir- ^'-77-7 * **b\* 

such as g*n*r*.ting this bit in th* CRRRV betor- ^hif+'n^ - -i»l sottwar* case, 
specitied in *. term which indicates which ot the’l* *1 m ;i‘ . a *7 h b - 

which et^th* *ight octaves th* semitone is in. Sinc-'f.C hi--' d **ir*d, 

octaves, th* interrelation can tit in on* byt*. ^h'^f - ** l **t 1 ot * 

th* s*m i ton* < by addressing th* look-up tablet. ir , d *<-'1 “*T r nv * te l * ** lecting 
by th* division routine to determine how man--- tim-* "*h-’*^fc7- nVb '? 1 * b * in « 
right-shitted. *- l* w*lu* must be 



LS 


' *• ' r*t- .Vt*. 








APPENDIX B - SID ENVELOPE GENERATORS 


Th* 


•eoui—r»-?j— t. PDSR ''ATTACK, OECAV 
has been proven 
bewteeri t 1 


SUSTAIN. RELEASE.' *r>v« lc>r*« g*n*r£Tbr 
in * le-cTri-nic music To provici* r.h* opTimum Tr*..;|.»—o-TT 
‘?ibi Utv .ind oT ar^U'd.id* corvS.-o l. Apprc-rri-aT* s’* l^cTi bri 

•:<T fnv* 1 op« p-ar^/ft*r^rs -fellows Th* ?imu UTion o+ *. wid* r*ng* o-f r-'-ercur^ior. 
*rid sus-6*in-"d^ins*cr'uffi€'rrts. Th* uiolin is *. good *xwhp l* ot * sus-t-fei r.id * * 
ir^TrumenT. Th* violinirr centre Ir th* ve l urn* by bowing The insrrunwt, 
Tyric-felly, The volume builds slowly, re*c,hes fe peek, -then drop; To *n 
inTerrnedi*.Te level. The violinisT can m*.inT*.in This level Tor «'long 
desired. Then The volume is allowed To s low ly die away-. A "mwshot" oT^Th' 
envelope is shown below:- 

PEAK AMP LJTUD £__ 


IWTHRh£5\flTE L£Y£l_ 

Z-*»° AMfUTUOg- 

. uo } um * envelope c*n be eesi ly reproduced by The AD3R es shown below 
'* w «"i ^-'PiCi .1 enve lop*? rates : 



10 
© 




ATTACK: 

DECAV: 

SUSTAIN: 10 <SA j 
RELEASE 2 3 


50*3 mS 
300 m3 

738 mS 



NoTe that The Tone cen be held at The inTerrnedie.Te SUSTAIN level . 

long as desired. The Tone will noT begin To die away uhTi l GATE i^- ril-r-lw 

«*weTr« tint nS!° nS ' b " iC * nV * lopS * C4n to * U3 ~ d bress end woodwinc 

An entire ly ditterent- torm ot enve lope i3- producs-d bv p^rcusricn 
instruments sueh as drums, cymbals and -jongs, is uu« U is certain'*ktybo^rd^ 

- uch ^ * nd harpsichords. The percussion enve 1 ope is character< 

by a n*ir ly instantaneous attack/ immediate ly to 1 lowed by a. dec^y to 
volume, Percussion instruments cannot: be sustained at a constant " * ~* n ° 
amplitude, For examp , -the* instant a drum is struck. the sound " 
reaches full volume and decays rapidly reoerd less ot how it was rtrurU 
typical cyrnba. 1 envelope is shown below: * 


AiiACK: 
OECAV : 
SUSTAIN: 
RELEASE: 


2 m3 
730 m3 

738 m3 



GnTc T 


Note that the tone immediately begins to decay to zero a/np 1 ituri*. 
attar The peak is reached/ remand less ot when CATE is cleaned. * 

anve lope ot pianos and harpsichords is somewhat more comp Ucet^d ' u ***** 
b e generated Auite easi ly with the AD SR - These instruments n 2 * r l. bui? - 
volume when a key is first struck. The amplitude irnmedi ate ly ’ kI? . * u 11 
slowly as lon<? as the key remains depressed. It the key 

tu 1 ly died away . the amplitude «»»i 1 1 ^ 


a.wa 

cetera 

-arc. 


the 

Thi^ 


rt i 


rrflCK : 



14 

0 


Found has 
enve lope 

4 . m3 

730 m3 
£ m3 


is shown below: 




UTl.3; 

an' 

die 

ed 

op ty, 




^ -h->T Th'r Tone- d~c*y? 5 lowly 


po i f ' 1 


No* 8 * 

rhT 


^ntil DATE is c lea 
arnP li *’^o<e drops rapid lv to zero. 


^*d. - * 


wh i ch 




. * ■ -»*L-'- H.y. t 

. <■ 
















Th-f nriO£”t :?i;np le* lop** 

ton* imrri 4 *di-e.-fc* ly 
ix r* Uij’.rd - th* -ton*' drops i 
Jhomn b»r \o«.u : 


is *h*-t o-t *h* Orci*/*i. Uh*n k*v ir 

-tu 11 uo lurri* *nd r*rn*.ins rh^r-c.. wh*n thr"k* 

rr.ff.*di*T* ly -fee. =*r-o uo lurr.*. This *nu* Ion* i 


■d , 


ATTACK: 

© 2 

rnS 

DECAV: 

© 6 

m3 

SUSTAIN: 

15 


RELEASE: 

0 £ 

mS 


S 



Th« r**.l now*r* oV SID li*s in Th* *bi liTy -to cr**T* «riai n .i _ _ _ 

■Sh*n simw lotions 0+ *.cous-iic ins!rum»ntj. Th* ADS P ir iin .: , * sounds r*.Th*r 
«*nu* lop«s which do not com-snond To my s ° + cr***tin« 

would b* Th* " b*cki'.<-cT«is" wm* Ion*. This -nu* Ion* is ch^ri*- _ <?cod 
slow t.tt^.ck ?nd r»nid d*c*y which sounds y*ry mu^h lii-*' k -’ y *• 

h*s b**n r*cord*d on T**.* Th*n n l*y*d b*cku.«rds. ’ Thi-'^. * n *' Sr *'-iw.*nT Ths.T 

en^icp, is shown b* low 


ATTACK: 
DECAV: 
SUSTAIN: 
RELEASE: 


1© 


5QD mS 

© 


0 mS 

15 

* 3 

<SF> 

'4 

l\> 

3 

(0 



w sr l_ 


M*ny uni^u* sounds cs-n b* cr-**T*d by spp lying on* *m - 1 - 
o-P on* injtru(n#nt -to Th* harmonic ftructurt o-P inothsr - 1 L? ud * *nu* ion* 
sounds simi l*r To -pjuni li*n acoustic instrum*nt;, x *-fe no-tsJi * l ° r,: " :<u ' :{ ’ s 
In g*n*r*l, sound is <*uiT* subj*cTiv* *nd *xp-*p i»* n T*.Tih^T' lX . di "^ i " r ' %n ' S * 
*nu*Ion* r*T*s ind himonic contents will b* n*o*ss*rv- i u ' 1 ~ h u*nious 
Th* d*sir*d sound. n ° rc **P To *chi»u* 


n 
















r*“N . 










appewoik i>- 

TYPICnL C58! SID APPLICATION 

















































SECTION III 


Commodore 64 Memory Maps 





COMMODORE E** MEMOPV MRP 


r *—UoEFUL MEMOR v LOCR T ION * 


MF' 


DECIMAL 


DECOR IPTI ON 


oooo 

0 

E5 1 0 Oe.te—d i roct i on 

000 1 

1 

E510 Output ^e^ister 

0002 

2 

Unused 

O003-OOO4 

3-4 

F 1 o e.t - F i x * d o e c t o r 

0005--000E 

5-6 

F i xed-F loe.t ec tor 

0007 

f 

Se en ch c h er e.c t e r 

000:5 

3 

Seen—quotes f l*ii 

O0O9 

•3 

TftEi co lumn save 

000 ft 

10 

0=LOftD.r 1 =VER IF V 


00 OB 
O 0 QC 
0000 
000E 
O00F 
00 1 0 
00 1 1 
00 I 2 
0013 

*00i4-0015 
00 1 E 

00 i 7 - 001 x 
0019—0021 


0035 — 0 O 3 A 
OOOB-OOOC 
0030-003E 
003F-0O4O 
004 1 -0O42 
*0043-0044 
0043—0046 
0047-0040 

L :i 040--0040 

0040-0040 


1 1 
12 

13 

14 

15 
IE 

1 ? 

1 

19 

20-21 


OO22-0025 

34-37 

Uti 1 ity pointer 

002E-002ft 

33-42 

product eree. tor 

*0028-01020 

43-44 

Pointer: Stent o 

*002D-002E 

45-43 

Pointers Stent o 

*002F—0030 

47-48 

P o i n t e r : S ter t o 

*0031-0032 

49-30 

Pointer: End ot 

*0033-0034 

51-52 

P o i n t e r : S tr i n u 



down > 

0035—003E 

33-54 

Uti lity string p 

*0037-0033 

55-36 

Pointer: Limit o 


59 —E *0 
E 1 -E2 
E3-E4 
E5—EE 
E7-ES 
69-70 
71-72 

75-7 E 


Input tau-P-Per pointer/# -.ulv-rript 
Oe-Pau It DIM -P l 
Type : FF=str in*i.. 00=numeric 
Tyr--*: 33= inte-ner00=f loa.tifvn point 
C'AT A scan/LIST <iwote/memorv f la.* 
Subscr i pt/FHx -P la.* 

®= I NF'IJT : *40=GET; #38=READ 
ATM -s i iin/Comp-ar i son •=••..•.=..1 -f | -. ;i 
Current I /0 prompt -f 1 
Int^'iior value 

Pointer: temporary string stack 
Lest t©mp str 1 n* oootnf* 


Basic 

'••■'•s-r i ab les 


- ,r ='•'-<* ■■ moo i n-:j 

i nter 
memory 
number 

_ number- 

Pointer: 1 ■_ s ta.tement -p,;, r COHT 


Current Basic lin 
Previous Basic line 


0040 

77 

Comper i son syrnbo 1 

00 4 8-0053 

73 

Mi sc i.uork .=*nee, p r 

005^-0054: 

04-66 

Jump vector tor -h, 

0057-e»060 

37-93 

Mi sc numeric work 

*003 1 

97 

Recum#1: Exponent 

*0032-0065 

3 : 5 - 10 1 

ftccum#l : Merit ii-r^ 

♦ 00 EE 

102 

He cum# 1 : Si •rm 

0067 

1 03 

8 er 1 es eve. lua.t 1 0n 

00E3 

104 

He cum# 1 h 1 -c«nd^ r . 


Current DATA line number 

0 U P P >r* H t OftTft O.d H f- >=, 

Input vector 

Current variable name 

Current variable -j r _ 

Variable pointer 7 : , r . foJ^ NE vt 
V- seve; op- se.o* • p. _ . * nt -• 1 

•' c '*^ 1 C Km"i i nfpr «:e 

ooffipar -1 son sy mbo 1_ r - 1 r lT ^ r - 


Jrnu Lai:or 


constant poi 
' , -"v , er+' low > 


..vii 







he* 

DECIMAL 

DESCRIPTION 

00 K9—006E 

105-11© 

0ccum#2 : Exponent * etc* 

Q06F 

111 

3 i u n c o m r ar i s o n.. 0 c c # 1 v s # 2 

3070 

112 

He cum# 1 lo—order •' round inu> 

0071-0072 

113-114 

L*ass e 11 e butter lenuthdSor l es 
nointer 

*007S—00S H 

115—136 

CHR0E T s ubrou* i ne < ■:<et BOS IC char 

007A-007B 

122-123 

Bas i c ro i nter < u.i i th i n subrout i ne > 

003B-003F 

133—143 

R M 0 s e e d y a 1 u e 

*0030 

144 

Status word ST 

003 1 

145 

Keyswi tch PIfl: STOP end RVS t la*:<s 

0092 

146 

Timing constant tor tare 

0033 

147 

L o ad = h .r V e r i ty — 1 

0034 

143 

Serial output: deterred char t la*3 

0035 

143 

Serial deterred character 

0036 

153 

Tare EOT received 

0037 

151 

Reci i ster save 

#0098 

152 

Hou.i many oren ti les 

*0093 

153 

Inr ut device <normally 0 > 

*0090 

154 

Output <CMO> device normally 3 

003B 

155 

Tare character rarity 

003C 

156 

Byte—recei ved t lau 

0030 

157 

0 i rec t=S:30/RUN=0 out rut contro l 

003E 

158 

Tare Pass 1 error loudchar butter 

003F 

159 

Tare Pass 2 error loo corrected 

* 0 0 0 0 - 0 0 R 2 

160—162 

Jitty Clock 'HML/ 

0003 

163 

Ser i a. 1 bit countdEO I t lau 

00R4 

164 

Cyc le count 

0005 

165 

C o u n t d o w n , t ar e w r i te d b it c o u n t 

0006 

166 

Pointer: tare butter 

0007 

167 

Tare Nrito Idr countdRead rassdinbit 

0003 

168 

Tare Nr*- i te new bytedRead errord i nb i t 
ent 

0003 

163 

Nrite start b i tdRead bit errdstbit 

0000 

17© 

Tar e Sc ar ; L-n t; L d; Enddtay t e as sy 

000B 

171 

Write lead lenuthdRd checksumdrarity 

00OC-00OD 

172-173 

Pointer: tare butter, scrolling 

00OE-00OF 

174-175 

Tare er*id addressesdEnd ot rroura/n 

00B0-00B1 

176—177 

T ar e 1 1 r,i i nu c o r*i s t an t •=: 

*0062-0063 

178—173 

P o i n ter: s t a/*-1 o t t ar e b u 11 e r 

00B4 

18© 

Tare t i rner < 1 =enab le > ; b i t cht 

0065 

181 

Tare E0TdRS232 next bit to send 

0066 

182 

Read character errordoutbyte butter 

*0067 

183 

# characters in ti le name 


*:00B© 


:*O06R 

*o©e&-s® e,:: 

0060 

00©£ 

00i 6© 

0@cy 

00-: i -*** 

00C6-OO'-- 

:*:£i£C5 


134 
183 
186 

137 - 138 
139 

190 

191 

192 

193-194 
195-136 
137 


Current secondary -address. 

Current dev ice 

Pointer: to tile na/ne 

Wr i te sh i ft worddRead inr ut ch er 

# blocks remai n i nu to Wr 11 ^/p,- . ^ 

•r-er l a 1 word butter* 

Tere motor i ntor lock 
I/O ?ter + Addresses 
Kernel se*ur oointer 
L’ijr *r *er • t l-.ey nf■ ee.?e**^ 




cr ^*.v'V / 2 /...._• . 




HEX ' 

DECIMAL 

tO0C6 

133 

4i fulir:7 

133 

©ecs 

200 

00C'?--00C:h 

201-202 

t00C8 

203 

©0 CC 

204 

00 CD 

205 

0©CE 

206 

00CF 

207 

0000 

203 

*0001-0002 

209-210 

*00OS 

211 

0004 

212 

*0005 

213 

*0006 

214 

000? 

215 

1001OC 

216 

*00O3—00F0 

217-240 

00F1 

241 

00F2 

242 

*00F3-00F4 

243-244 

00F7—00F^ 

245—246 

00F7-00F8 

247-243 

00F9—00FA 

243-250 

*00FB-00FE 

251-254 

00 FF 

255 

0100-010A 

256—266 

0100-013E 

256-313 

y1yy—0IFF 

256-511 

*0200 - 025S 

512-600 

*0259-0262 

601-610 

*0263-0260 

611-620 

*0260-0276 

621—630 

*0277-0230 

631-640 

*02B1—0232 

641-642 

*0233-0284 

643—644 

0235 

645 

*0236 

646 

0237 

* 647 

*0233 

643 

*0233 

649 

*023A 

650 

*0238 

651 

023C 

652 

*0230 

653 

023E 

654 

023F — 0 2 cj 

655-656 

*0231 

657 

0232 

— e* ( 

0233 

£5? 

0234 

F.F.m 

0235-0233 

FF. 1 — F'O* 2 * 


DESCRIPTION 

tt ch5/'s in butter 

Screen r-egersi? t la* 

Po i nter : End-ot- 1 i ne for 1 nrut 
Inpuf cursor lo* (row,, co lumn* 
Which key: 64 it no key 
cursor enato le <©=t lash cursor.':* 

C ur s o r t i m i n •:< c »:•u n t d o i.m n 

Character under c ursor 

Cursor in b l ink phase 

I nput -from screen/tr-om keyboard 

Pointer to screen line 

Position ot cursor on above line 

0=direct cursor, $ Iso pro«rsm#ed 

Current screen line length 

Row where cursor lives 

Lest i nkey/checksumr'butter 

4 o-f' INSERTS outstand i r>:< 

Screen line l ink table 
Dummy screen link 
Screen row marker 


Screen color pointer 

Keyboard reir ter 

RS-232 Rev pointer 

RS-2S2 Tx pointer 

Operating system tree zero pa.*ie 

spe.ee 


Besic store.*ye 

F loe.tin*:i to ASCII work area. 
Tape error lo*i 
Processor ste.ck area. 

Besic input butter 
Lou i ce. I t i le teb le 
Device 4 teb le 
Secondary Address teble 
Keyboard butter • 

Start ot memory tor op system 
Top ot memory tor op system 
Serial bus timeout flag 
Current co lor code 


Co lor under cursor 
Screen memory r a*e 

Ma.v a 1 ze ot* keyboard butt 
K a y r e r e at 1 1 =l y=r a f:• a a.t 
Pereat sreed counter 
Repeat de lay counter 
Keyboard Shitt/Contro l f i - . 
La^-t keyboard shift 


er 

•=*• l l keys !:* 


Pointer: keyboard decode 
Shitt mode switch 
12S= locked> 


ern 
tab le 
' l - 1=s eneb led. 


hijto scro l l douiri -p i - 

, . ' ' r 1 s^SKtis 

1 r **i 1 s ter 

w' ; ; c.‘ command r>=..-<, _ , 

• iU i.ttlr. 

i atan da/ *d & i t. 

• i rria/2-10© > 


on , O0=ott) 






HEX 

DECIMAL 

DESCRIPTION 

i3£37 


RS-232 status register 

0238 

664 

Humber ot bit; to send 

0233-0233 

663—666 

Baud rit>? C+'u 11) bit time 

023B 

667 

RS232 receive pointer 

023C 

66*r* 

R3232 input pointer 

0230 

669 

R3232 transmit pointer 

023E 

670 

RS232 output pointer 

023F-02R0 

671-672 

Ho Ids IRQ dur i ng tape opere.t i ons 

02R1-02FF 

673-767 

Program i nd i rects 

*0300-0301 

763-763 

Error message link 

0302—0303 

770-771 

Basic warm st.art link 

0304-0305 

772-773 

Crunch Basic tokens link 

0306—0307 

774-775 

Print tokens l ink 

0308—0309 

776-777 

Start new Basic code link 

0308—0308 

773-773 

Get arithmetic element link 

030C 

730 

Storage tor 6582 .8 register 

0300 

731 

Stor age tor 6582 . X reg i star 

030E 

782 

Storage tor 6582 .V register 

038F 

733 

Storage tor 6SO2 .P register 

0310—0313 

734-737 

USP .j ump 

0314-0315 

733-783 

Hardware IRQ > interrupt ■••■ector 

C FEflB > 

0316—0317 

730-731 

Break interrupt vector 
<FED2> 

0313-0313 

732-733 

MMI-interrupt vector 



■:;fefio> 

0318-03IB 

734-735 

OF’EM vector 
< F40 h > 

0310-031D 

736-737 

CLOSE vector 



<F34fl> 

031E—031F 

738-733 

Set—input vector 
>■. F2C7 > 

0320-0321 

300-301 

S e t—out put vector 



< F303> 

0322—0323 

882-883 

Restore I/0 vector 
<F3F3 y 

0324-0325 

804—305 

INPUT vector 



<F28E> 

0326-0327 

806-887 

Output vector 



<F27fl> 

0323-0323 

808-883 

Test-STOP vector 



F770 > 

0328-0328 

810-311 

GET vector 

<F1F5> 

0320-0220 

812-813 

Abort 1/0 vector 
<F3EF > 

032E-O32F 

814-815 

user vector 

CFED2> 

0330-0221 

816-817 

Link to load RAM 

CF549 


313-313 

L i nk to save PAM 


F685 

-^4-033® 

320-327 



*.-*»* £*& * 


■jCu^~Z *• -’/• ‘..« v '.v. 






■^ut; 


HEX 

DEC IMAL 

OESCRIPTION 

y *3 3 C “ y -3 F B 

•320-1013 

L*eSSette butter 

040©-@7FF 

1024-204? 

IK Screen memof'v 

•:. 0400-07E7 

1024-2023 

Video rno.tr -1 x) 

•:: 07^:5-07FF 

2040-2047 

3p rite po i n t e r-s ;■ 

0 x 0 0—'3 F F F 

20143-401959 

User- Bes 1 c .sr*.s 

R000-BFFF 

40960-49151 

3K BfiSIC ROM 

0000—CFFF 

49152-53247 

4K RAM 

O0001-O3FF 

53243-54271 

6567 Video Chirr- 

0000 

53243 

Sprite 0 X crnp 

000 1 

53249 

Sprite 0 V crap 

0002 

53250 

Sprite 1 X crnp 

0002 

53251 

Sprite 1 V crnp 

0004 

53252 

Sprite 2 X crnp 

00105 

53253 

Sprite 2 V crnp 

0006 

53254 

Sprite 3 X crnp 

0007 

53255 

Sprite 3 V crnp 

001010 

53256 

Spr i te 4 x cm*: 

0001? 

cr cr -7 

Sprite 4 V crnp 

00101ft 

53253 

Spr i te 5 X crnp 

0Ci 0i B 

53259 

Spri.te 5 V crnp 

0000 

53260 

Spr i te 6 X crnp 

00100 

53261 

Sprite 6 V crnp 

OQQE 

53262 

Spr i te 7 X crnp 

O00F 

53263 

Sprite 7 V crnp 

00 1 0 

53264 

Sprite X crnp (rnsb 0 

00 1 1 

53265 BIT 7 

Rester compere 


BIT 6 

Extended co lor mode 


BIT 5 

Bit rnep mode 


BIT 4 

Screen b lenk 


BIT 3 

24/25 Row se lec+ 1 


BIT 2- 

0 Scroll in v rosi 

0012 ■R/0> 

53266 

Res ter ree.d ''reste 

0013 ' R/0 

53267 

Light pen letch v 

0014 • R/0 1 

53263 

Light pen le.tch V 

0015 

53269 

Sprite eneb le 1 = =■ 

0016 

53270 BIT 7 

-5 Unused 


BIT 4 

Mu It i —co lor* mode 


BIT 3 

33/401 f:,;. lump re lee 


BIT 2 

-0i Scro l l in X pos« 

001 7 

53271 

Sprite expend ir*i 

001 :=: 

58272 BIT 7 

-4 Video rne.tr 1 * bes- 


BIT 3 

-1 Cher-e.c ter cpe.ce i 

0019 

53273 BIT 7 

Follow* IRQ line 


BIT 2 

IRQ tor sprite t, ; , 


BIT 1 

IRQ tor sprit* t.; | 
co l l i s 1 on 


BIT 0 

Rester cmp l RQ 

00 1 A 

53274 

IRQ mesl- eg 1 *•*•*.- 


coorci. 


■OMJS’. 


•:o l. > 


— N'f • i *t* >Zu - ^ , 

i. - I lisiort 

:<r Jn , ; j 


d i s“4:» 


*• 1:2 


i ri + Ar-njf:-± 




•-..v,w* S*.*.*^ js 












00 IE 

CT 

32 7 3 

E-5.ckiir’ , oijr‘n:i to =:pr- i "te >:>r i or'- : 

09 1 c 

5 

3276 

Mu ltr-co lor sprit.*? =■*? loot 

0010 

5 

-*c_ r r* 

Spr- i to expend i n " X “ 

001 E 

5 

3273 

Sprito to spr i to col 1 ision 

09 1F 

c* 

•_l 

3273 Spn i te to to-scksjnound colli.-- 

detect 

COLOR REGISTERS <BIT 3-0> 

0029 

3 

3230 

Bordst' co lor 

0921 

3 

3231 

Background co lor 9 

0922 

3 

3232 

Background co lor 1 

0022 

3 

3233 

Background color 2 

0924 

32284 

Background co lor 2 

0925 

erj i~i ej 

Spr ite multi-color register 

0026 

33236 

Sprite mu It i-color registar 

0927 

3- 

3237 

Sprite 9 color 

0028 

5: 

2288 

Sprite 1 co lor 

0923 

3: 

2289 

Spr i te 2 co lor 

D02A 

33233 

Sprite 2 color 

0028 

3: 

2291 

Spr i te 4 co lor 

D02C 

33232 

Sprite 5 co lor 

0920 

3: 

3233 

Sprite 6 co lor 

092E 

0490—OTFF 

3 : 

3234 

Sprite 7 color 

6581 <SI0> SYNTHESIZER CHIP 

0490 

54272 

FREQUENCY LG 

0401 

54272 

FREQUENCY HI 

0492 

54274 

PULSE WIDTH LG 

0492 

542 r 5 

BIT 7-4 UNUSED 

BIT 2-9 PULSE WIDTH HI 

0494 

54277 

CONTROL REGISTER VOICE 1 


tect 


0405 

040*5 

04157-0400' 
O40E-O414 



BIT 

—* 

NOISE 


BIT 

6 

PULSE 


BIT 

5 

SAWTOOTH 


BIT 

4 

TRIANGLE 


BIT 


TEST BIT 


BIT 


RING MOD 


BIT 

i 

SYNC 


BIT 

0 

GATE 

54278 



ATTACK/DECAV REGISTEP 

54279 



SUSTAIN/RELEASE REGISTER 

54289- 

-34235 

CONTROL REGISTERS FOR VOICE 


< FUNCTI ONRLLY IDENTICAL TO 0400-0406) 


54286-54232 CONTROL REGISTERS FOR VOICE 2 
<FUNCTIOHfiLLV IDENTICAL TO 0400-0496) 





-'-aJiat' -waitev*. «&i..ja»5.45<4tfO«iv 


•• ej&tiss&ikm 





HEX 


DEC INAL 


OESCRIFT IOH 


04 1 5 
D416 
D417 


54 233 CUTOFF FREQUENCY LO 

54294 CUTOFF FREQUENCY HI 

54295 BIT 7—4 RESONANCE OF FILTER 

<;eiT 3-0 SELECT SIGNALS TO BE ROUTED 
THROUGH FILTER 

BITS SET TO ZERO APPEAR DIRECTLY AT AUDIO 
OUTPUT, 




■ BITS : 

SET TO 1 WILL BE PROCESSED THROUGH 




FILTER* 



BIT 3 

EXTERNAL INPUT 



BIT 2 

VOICE 3 



BIT 1 

VOICE 2 



BIT 0 

VOICE 1 

D418 

54236 

< BIT 7 

-4 SELECT FILTER MODE AND OUTPUT 




OPTIONS* 



BIT 7 

OFF 



BIT € 

HIGH PASS 



BIT 5 

BAND PASS 



BIT 4 

LOW PASS 



BIT 3 

-O OUTPUT VOLUME 

0419 

54237 


POT X 

041A 

54238 


POTV 

041B 

54233 


OSCILLATOR 3/RANDOM NUMBER 




GENERATOR 

041C 

54280 


ENVELOPE 3 

OS0O-OBFF 

55236- 

-56319 

Co lor RAM fi i bb IIS'S * 

OC00-OCFF 

56320- 

-56575 

CIA #1 {Ksybo-arcO 

0000—DOFF 

56576 

-56831 

CIA #2 (user port:/rs-23'' , '’> 




IJNFINI SHED DOCUMENT AT ION 

OEO0-OEFF 

56882 

—57087 

I/O expansion block i 

OF00-OFFF 

5 r yyy 

-57343 

I/O expansion block 2 


eooo-ffff 


57344-45535 SK Kema l ROM 


'A. ,Vr- 










oto V j-nr*i *?•=•• 

ONMOOCPs V-r.l l *y . I l*fi 

5/n/sz. 


COMMODORE—;'4 CONNECTOR RIN-OUTS 


CONTROL POST 1 
<5-PIN MINI—0 > 

OO 
O 

•u #' 

3> . 

£> 

BUTTONA/LIOHT PEN CKybd Row 4> > 

-r3 VDC <. To To. I BoTh PorTs 30 rriA m=cO 
GND 
POT A 


CONTROL PORT 2 


1 _ _ 

JO VA 

0 CKytod 

Row 

•' — 

JOVA. 

1 <Kybd 

Rom.* 

3— 

JOY A 

2 < Ky tod 

Row 

-r— 

JOVA 

3 <Kybd 

Row 

<r_ 

ROTA 

V 'CKytod 

Col 


•CKybd Col £> 


SERIAL BUS 
C5-PIN 01N> 

- SRG IN 

- GND 

- ATN IN.-‘OUT 

- CLK IN/OUT 

. OPTP IN/OUT 

- RESET 


1- 


4 .— 


auoiq/vioeo 

<3-PIN 01hO 
LUMINANCE OUT 
GND 

AUDIO OUT 
AUDIO IN <3 Vr>—f* 
COMPOSITE VIDEO 


m.=c: 



< 

5-pin mi; 

NI-0 


1 - 

JCVB 

0 OCybd 

Col 

0 !> 

2 - 

JOVB 

1 v. Kybd 

Col 

n 


JOYS 

2 CKybd 

Col 

2 > 

4- 

JOVB 

3 CKybd 

Col 


e* 

w— 

F'OTB 

V <K>*bd 

Col 

r> 

£— 

BUTTONS,- _ 

+3 VDC 

• - 

•sKytod Co* l 

•v— 

OND 




3— 

ROTE: 

X CKybd 

Col 




POWER 




-PIN 

DIN AS; f 

=, EP i 

CBM spec y 


1 - 

OND 





OND 




3— 

OND 



> 

4- 

+3 VDC « 

CTox 

r.l 


e* 

+3 VDC 

1.3 

A r«‘i •=*.'< > 


S— 

S VAC-r 




ol 4> 


^ *-• “ '• T o t.r.l /f! 0 o r,*, p 

HI ELD— ©NO 


rr« 


• CASSETTE 
VvJUPL o—PIN MALE pc> 
i.A— OND 

C -B- -S _ VDC CC-sss-r-ft-SiS. onl>0 

3*C— CA&b MTR 

4.0- CASS AD 

5.S- CASS WRT 

R.r- CASS SENSE 


USER PORT 
DUAL I2— P IN r^ALE 

GND 

VQu -■ 100 rrip 
RESET 

cnt 1 
SP l 
CNT 2 
_Sr 2 

*th in*-'out 
!a VAC + ’ To T.r.l 
=. vac— ■ * go mA fn.s.. * 
CiMC 


PLy 


L- 


1- 


4- 


CAR’TR I 0GE/E/1P ANSI ON 
CDUAL LL—PIN FEMALE pt*' 

"OND 

+3 VDC <ToTo.l USER PORT. ■* 
*4*3 V DC CART 4.30 rnp 
IRQ 
R/W 

DOT clo ck: 

I/O #1 


S— OnTTE 



EXROM 


10 — I.-'-' w. 

OND 

11- Puml 

FLAG 2 

12 - eft 

FBO 

13- DMA 

PSl 

14- 07 

P82 

IS- 0-5 

PBS 

. 16- OS 

PS4 

17— 04 

pC ; «r 

IS- 03 

PBS 

15— D2 

PS? 

20 - 01 

PA2 

21 - OS 

GND 

22- OND 


T- A: 




(X&i __ 




-- 




















■-*-•1 ui 'v r. i ; —y rop^tia, ij,*-t 

- c/i- rr ci 


s*A 7/S’e. 

-A* 10 I/O PORT <S0001> 


COMMODORE-c 4 I/O ASSIGNMENTS 


“0— U'JriAfM <! OuT?ii.4T > 
. ■* i - n i RAM < 0 *.^AbU T- > 
R2- 


o -r' 


PS- CASS 

WRT 

< Ou7nuT> 

R4- CASS 

SENS 

E <Inru"fc> 

P3- CASS 

MTS 

<OuTruT> 

IA rtl <SQC 

30 > 


RAO- Kybd 

COL 

O/JOS'B 0 

RA1- Kybd 

COL 

l/JOVB 1 

PA2- Kybd 

COL 

2/JOVS 2 

RAS— Kybd 

COL 

3/JQV8 3 

RA4— Kybd 

COL 

4/BUTTONSL 

RAS— Kybd 

COL 

5 <Ou“truT> 

RAS- Kybd 

COL 

■S/ROTA k\.POTA V 

RAT- Kybd 

COL 

7/P0T8 X .0 POTS V 

PBS- Kybd 

ROW 

0 / J ill V A 0 '•! I n p A > 

RBI- Kybd 

ROW 

1 / J OVA 1 < I nru A > 

RS2- Kybd 

ROW 

2/ J 0 S' A 2 < I ri r u A > 

RBS— Kybd 

ROW 

3 / J 0 V A 3 •;* I n ^ u 7 > 

RB4— Kybd 

ROW 

4/BUTTONA/LIOHT 

RBS- Kybd 

ROW 

•5 (Input) 

: ‘BS- Kybd 

ROW 

E <InruT> 

r ’37- Kybd 

ROW 

7 (Inpu^> 


3 

1 


> Memor* 


■•* H.?ri.r.oAr,i“n“ 

I fiTcrr’-ce 


SELECT < Output > 
SELECT < OuT.?:*u*t > 


'ri/O.i/fi-r I/r 


REN < InruT> 


RD/SRQ IN 


FLAOl- CASS 
SPl- USES 
ONTl- USES 

CI Pi R2 < SQQO$:j 


P A0 — VA i -V < 0> 

RA 1 — vA i z> < Ou“?mjt > 

r'Fi- USER/RS-232 TRANSMITTED DATA 

P AS- ATN OUT (Output) 

RA4— CLK OUT ODu’WulO 
RA3— DATA OUT <0u vput) 

RAF— CLK IN In?:*uT> 

RAT - DATA IN (Inpul?) 


L^s*^- In A 


'= , f-T , r.ce/SER IAL BO*- 


_( ^ H A *-«h-*or.:^ r Addr*^=* 5 : ~-= 

— r --*— LUL I nTc r? -* 

AI AL DUS 


P S 0 — U 0 ER / R S— 2 3 2 
RSI- USER/RS-232 
rS2- USES/S:-:-232 

FB4- USER/RS-232 
PS3- USER 
= ES- USER, RS-232 
; sr- USER, 'RS-232 


RECEIVED DATA/N*=• t«.«orl< 
REQUEST TO SEND 
DATA TERMINAL READS' 
RING INDICATOR 
RECEIVED LINE SIGNAL 

CLEAR TO SEND 
DATA SET READS' 


r L rsL'L— ‘J-i-w".,' 5 —232 DECEIVED OATA/NAT:y;-,f-; : 

ERL — D r.T- r. 

j NT 1 - , - !; - 
r^T- USER 


'- ,: :S.= . = 0.= T, = :_v j:I: lr~* r ~ y -* 


- ’ *•• if r-r ;**• — r.'l *=* 


. : .:*>*- 


: 

■ 

























E-*:*b Vrjin-2 

COMMODORE Vc.l Uy , IJSR 


COMMODORE-*4 MEMORV MhR CONTROL 


i**i*=* E310 Mi••iror: , f':"ir*-=T-:r mi*.:! in 

i ■=■- rri-rfiic.ry. R-r Tb*s* COMMOOC*F:S —*4 

:t I/O in r.udiTion to t. u i* .f-K 
TO .7.1 low T, L 'i*r m-r.ViOry .Vi.=•„»:• to b*? 
cor'iTrol l in~£ -~r~ prov id*d to 
oontro l l in-r-i: .=./-•=• provided by 

i.r;ni If Th* rc.fiio.i n inu two l in—:? 


COMMODORE-c"4 »isn ^ddr*;? =■ up to E 4 K' 
con to. i ;*:•=* lvjK SyT^s Of ROM *nd 4K Svtaj 
-y—^-r ot .tjtM, rn€>mcr*y rnonr.*n*m•=• nt is prou *rjafj 
r^oont i -:<ur*d tor d i tt*r*nt «j>p l i co.t i ons . ’ F i y * 


^•rl'i-ot various memory m&>&. Thr*=•«=■ of th- 
th * 1/0 contained in th* 5313 pr«#wr. 

. '-.■ -*•.-- •-•••-■ ‘ * r ‘* supplied toy the plu«-in certrid**. Th* 

toSr,'"^er2d. ** ^' ~ h * m * £hln * ** ,:< *** rmin * what type ot cirtrid*; has 


Th«s* fhr-r* l in*:? 


on th** c’o i O < l oc r.t i on 0001 .=vr* : 


LORRM 


TXb ic&l ly LO RRM 
LOR.tM 

.Vi *r-f II >:.“•*•• 


HIRRM 


O.i- Oen^ro.l ly This l in* can b~ thought ot =. - - rr , n ^n^ l 
which teenies the 3K Byte BASIC ROM out ot the micr.-.prnr•• - 
address rpe.ee <however it interacts with the other cont /\ i7.. l>a . s 

produce yon i our memory oont i uur r.T i on-' > - — - 1 

is programmed high tor normal SASIC operation. ~- 
is programmed low., the SASIC ROM will disappear tr.-.w th* 
wep end toe replaced toy SK Bytes ot RAi trom sh000-sSFRF~ 

'-Sit i>- Oer.ere.l ly this l ine can toe thought ot ** .* , 

which barks the SK .Byte KESNfiL ROM out ot the mi~-.. .- 
address spe.ee <however this line e.lso interests with thl'nth^X 
■_on »ro i l i nes to produce venous memory conti .31 jn*ti,-, n —•, * *' 

Ty pice.l ly HIRA -1 is nno^r r/urn-r-d hi-:ih tor norm-sd~SASIC*,-'n^r ** •' . . * 

It HIRA-l is progr emmed low,, the KERHRL ROM will d/p/L *1 
memory map end toe repl aced toy OK Bytes ot RRM from sECCu-j-SFFFF 

< 3 i t 2 .'-- This line is used only to toenk the 4 K Byte Ch-n 
venerator ROM in or out ot the microprocessor 's eddreiV -y!~ -V 
trom the microprocessor 's point ot view., the Character'RhM'‘ 
resides in the seme address space as the I/O devi.-I.-" , 

4K Byte to lock trom sOOOO-sOr"F> . When CHARSN is prowr emlm*.-* 

V 1 . ' devices eppesr in the processor's eddrl-i- 

rnd the Character ROM is not accessible. It CHRREH 

lO'w,. the Character ROM will appear in the processor •* •=■” - i-ii*. --’•'‘me-: 
space end the I/ O devic es will not toe acce-ssitoiei " For "X'-'r-Tf f 
-'•ton., operation.. CH.nREH is programmed hi«jh. Real i =-t --1 {..' . 

microprocessor only needs access to the Character ROmT- L 7-* 
^“'-■s-ssar-./ to download the character patterns trom Ri*m - -~ 

•-or most applications, the CHRiREH bit w ill be Pro-^r Lmed ’ h i wP 
i* Should b*r not*.:! th^in som* CHRREH ix o^r^^u/u . 

- v. t^r- •• oriTr*o l l in^s »:! CHRF.EH will h.r.v*r no ,-, r , I ■'*'=■ 

'-OHT : ':iur.;-t i r, n v ,-c-, l *.;f5 TN-S- I/O d >£•*..' i Zfc’ > . '“arfftyry 


<1- 





















Ii! li«; 


r;=.rujrr. r :*inr CUN l KCL ConTi nu 


Tn* two rni*rf t iory control lines provided by The Crr^rick'* 


•r -re : 


<P i n £ > - ij*n*r-r.l l 
wh i ch • when l ow .. 


th i s l ine c:-;i be 


thought of r. con^ml 
s*<ses *•*“5' COMMODORE-o4 memory to 11 
into fh* memory rner of -hr COMMODORE IJLTIMAX video 
<however This l in* el so interacts with -hr Ofh«rr*o; 

1 ines to producs ver iour memory cont i-yure-t i ons;•. 

UL7IMAX 'H-r/fir cartridge.. this line would be ti*d 
-o the COMM000 R E—* 4 -he.t e GAME certridtj* * i-s- 

other words, the G0MM000ftE-o4 is downward comritib1 7*mi th th* 
ULiIMAa end eny certr id*ye which runs on th* 

rlucj directly into the C0MMQ0QRS-o4 end run. Wh*n no ,_ 

is installed. or when e. cartridge other then =■ .:,**>*. i-*" 
this line is held hi*h. .* “ " 


•Lie/ne 
I'ntro l 
On en 

low. indicatin'? 
bein^ use oh In 

thr 

ULTI MAX w ill e.l so 


used * 


EX A 0 M P i n *? > - this line 
s 0000 -S- 5 FFF out of 
rerle.ce it with up 
T his l ine would be 
such es "V£P" or 
COMMOOORE -o 4 the.t e. 


is used to benk the OK Bytes o«t 
the m i crorrocessor •' s address 
to OK Bytes ot ROM in the 
tied low on e. BASIC 


RAM from 
sre.ce end 
p l u *:j - i n <i or t r i d •? e . 
*:-<pens i on " certr i d*:i* 
Fro-t • wrtrn-rr •* s ft i " i „d i cs.t i n -:«. to th* 

eftJIC *xr»*n»ion Crrt.ri* t * < =■ h - < __, 

'• In ord*r for ?n -x^snxion o:-rfridcir to l.'. * *. ‘.fl - *. 

sSOtfe-sSeei must cont-sdn th* Cold t.-,r " i T. ^ _ 1 " 1 

*S®e£-^e03 nun contain th* w*rm Star-8 ' -J. 

s^hjA-S**** a U jt ojn-j.in "C3M38" (in ASCII, with 
on -o,-h ch*r*c-5*r in "CSN">. > Mh*n no car-w*i*i- h'4-*-tTh 
or «h*n c*rtrid«* other than an extension .-iC-rih- 7T , 
this line is held hi-:,h. 13 «**«' 





ii. 


vl **.».*«/•** ;.t »'**' 










ill lut 


COMMODORE V-5.1 l-v 


r*r-i i*, USA 




C0MM0G0RS-04 


PUNOAMEMTAL MEMORV MAP 


E000-r.-r.“ 

OK < 

KSRNAL ROM 
or 

RAM 



I/O 

0000-OFFr 

4K <: 

or 

RAM 



or 



CHARACTER ROM 

COOO-CFFr 

4K < 

RAM 



BASIC ROM 

AOOO--8FFF 

OK < 

or 

RAM 



or 



ROM PLUG-IN 

S000-3FFF 

SK < 

PPlM 

or 

ROM PLUG—IN 

4000-7FFF 

16 K < 

RAM 

0000—3FFF 

i SK < 

PPM 


I." : J 5 R E AKG0 WN 


0 00 0—0 0 F r 
D400-07FF 
0 O O 0—DBF F 
c C 0 0—O C F F 
0000—0OFF 
OEOO—OEFF 
OF 00—OFFF 


t r ; 1 *ro 11 *r :• 

X! : *ound :5yn-h*rsizer> 

LULgR ffrfiM 

j:.”* i*i Bus, Us*r Por-t/RS-'£32> 

I--0 Slo-fe SI <CP/M En.afcl •=■ .< 

•-•(.'•in j,0i.rL 


IK Sytr«&s 
IK 

IK nvbb l >*sr 

430 SyT-rs 
£30 S'-.-'T-'ts 
450 Syti-a-a* 


The Two Ofi^n 


II * 5rs -for '.iwnsrKl purpo-* ussr I. 0. i 

O cs* - ‘■■•---z :*-->> *s IS 52 > =.r,d h«u« te**ri 

1 CP,"'M =-n-:i for int»rf .=..;i n .I, t.-.'1 


,.; 5 U^ ” h * - 

; .r- hi #‘sl< sy ?-* m . 


for 
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COMMODORE-*-; MEMORV m ftps 

6 


Th* •fijUowin<) v-aJal«s i - -u,- 

*n Th* COMMODORE-*-;.. -*h* *i th** wsais *‘* 

m.»j» rnd «#h* irvs*nd#d us* *A *=.,*h * * " ,1 '~' x **fcih 


• :::= ‘ :i '-n ■' ~ C $•/*•*, 0= l *i.i.i 1 =h i :<h :< 


'—Q.R.RM s 1 
n i R:AMs l 
_ 0AME= 1 
?-E^u?T=i 

r l) Q Cu 

C 2oo 

OQO 

8ooc 


LiQCG 


O OO o 


OK 

KERMAL ROM 

4K 

I/O 

4K 

RAM CSUFFER'> 

SK 

&A*c. IC ROM 

m 

RAM 

16K 

. RAM 

1 *K 

1 

RAM 

! 


-n- aer^a- StfSIC m*morv 
which provides SASIC 2.0 =. r , c * 
copVvi*yu*5us Syfc*:* Ot us~r RFjM. 




A I R'RM=Q 
OAMS= i 

<Cacc 

E.'.R om=x 

icoo 

or 

CZCO 

_0’R AM=1 


— IF j^Mssy 

:-ams* o 

Sec o 


SK RAM* 


4K I/O 


4K RAM 

1 c’K riSn 


£.' .ROM=0 ^ 

ChriM£-i*=-r*\ 

^ *c c *r 

15 A^CT 

PicczxsteLZ 

£Y“THE CPU 
.AJ ”THl5 

<3000 


1 * K RAM 


1*K RAM 


I 


This M-*/> provides c-OK Syt~s of 
s./-,.;i I/O i •!€•.=. Th* U5*r 
writ-s his own I/O driver 

•• r.i.iT i n*s , 5 • 


HIRA Msfl 
0AM£ = 1 

E/ROM=/ 
or 


Cco< 


LORAMs sQ 
HIShM aQ 
OAMg = X ?<tce 
E/R0M=0 


Vo 0 0 



yc 4 q 

Tf • 1 JT -;i • i 

Bvt*s o* Ram/ £****** 


’MtI 


mus * te * -o^'Id b2.:., 1 t 









































































s(n/a 2 - 


MEMORV NAP'S < Con T i nued > 



Cc-CC 

'5 $30 

HOCO 

Qo o C 


1 * 

KSSMfiL ROM 

-K 

-•■'■o i 

! 4 K 

RPM <BUFFER> I 

OK 

5P0IC ROM 


R *J M CP RTF: 10 0 E 

ps i c e:-:r > 

loK 

RPM 

1BK 

RPM 


i his is The s"v•=•/*!I coni 5 i^ture.Tion 
«r * SASIC 3“- --ir-^-rn wiTh * BASIC 

ion RuM. This rn-s.p prov ides 
conTi-ituous ByTes oT user Rp.fi .and 
ur -o SK Byres oT BPStC '• Enhancement: •' 


LORPMs s 1 
HI RPm = l 
PPM £= @ 
E/%R0m=0 



This men preyides 3£K coni:iuuous 
Byres oT user RPM end up To 1 fK 
ByTes or plu<j—in ROM Tor specie.I 
ROM-besed enp lie e.r i ons wh i ch cion ■ 
require SPSXC »%word processors., 
oTher lenuu-e.^jes . etc. ). 


0RPM=0 


y i rp ms l 

® Coc, 

= X2jjM=* 6oei 
- 4 _ Co« 

A««o 

230 

qCIOO 


OK KERN PL ROM 


4K 

r,-o 


4K 

RPM 

BUFFER > 

OK 

ROM i 

CARTRIDGE 

OK 

RPM 


16K 

1 

: RPM 


1*K 

: RPM 



This men provides 4OK contiguous 
s.yt^s or user RPM end up To OK 
E.vTes or P l u*y- i n ROM Tor s?:*ec i eI 
ROM-bs-sed ?npl ice.Tions which dorv'T 
•-w-ryj i r e Br 1 *- • 


LORPM g# 
HIRPM=y 


PPMEa 0 
EXRGMs 1 


*Eooo 

icxj Q 

/Jooe 

&CCV 

Uc oo 

i ooq 

o <zzj 


OK 

CPRTRIDOE 

ROM j 

-K 

I.'-O 


4K 

OPEN 


OK 

OPEN 

! 

! 

OK 

CARTRIDGE 

ROM j 

1EK 

OPEN 

1 

i 2K 

OPEN 

i 

! 

i 

4K 

RAM 



. . grille 

memory men. More The.T th* oy 
Sv** "*xi»ins 1 on RAM" ^, ; , r 

UL I IMAJ-: . if r'-fqi.l Iff-rj . ' J ~ ' 

out Of Th-r COMMCQORff-^c'. r 'T*~ r ^' : 

5£!* ~ 




v 
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1 . > The "chAREN con+.ro 1 line will bank the Character ROM into the processors 
address sp ace in place ot the I/O devices wi th any Me mory me/* t he.t in cludes 
I/O devices O.uith the exception ot LuRAM=l, HIRAM=0, 0AME=0 end E/ROM=0>. 
Those memory centigura.tions which reple.ee the I s U with RAM ^giving 

access to e.l 1 64K Bytes ot RAM > ere unaffected by the CHAREN line. 

2. > In any memory me/* containing ROMs., a. WRITE to a ROM location will store 
de.te. in the RAM which the ROM overlays. The.t is, writing to e. ROM location 
i.i.iill. in tect, store de.te. in the "hidden" RAM. This e.l lows, tor example, 

e. HI-RES screen to reside underneath e. ROM end be cherried by the processor 
without banking the RAM into the processor's e.ddress spe.ee. Naturally, e. RE 
from e. ROM location will return the contents ot the ROM end not the "hidden 
RAM. 


> The ULTIMA/ memory me/* contijuration matches the memory me/* ot the 
COMMODORE ULTIMA/ video -name exactly. All open memory blocks in the 
ULTIMA/ ere also open on the COMMODORE-64 when this memory me/* is selected. 
Therefore, any cartridge or device that r* 1 ugs into the ULTIMA/ will also 
work on the COMMODORE—64. Note that there ere only 2K Bytes ot RAM. in th~ 
ULTIMA/ end tor explications requiring more RAM, the cartridge can contaiV. 
up to 2K Bytes ot expansion RAM. It an ULTIMA/ cartridge containing * 
expansion RAM is installed in the CdHMOOORE-64, the RAM in the cartridge 
will be ignored and the COMMODORE-64 will use its own internal RAM in^t^-d. 
The COMMODORE-64 Character ROM is not available to ULTIMA/ carfrid-n*^ A^. 
on the ULTIMA/, the 4K Bytes ot cartridge ROM from SF®®©-.*FFFF \=.reaccess!b 
by the VIC video chip and should contain all character end Sprite patterns. 


4.> All ot the memory maps described apply QNLV Tu THE MICROPROCESSOR 
VIC video display chip sees a. much simpl er memory map , regardless 
state ot the memory control lines <LORAM, etc..;. i h* VIC can 
see RAM or the Character ROM. The VIC chip itself is capable 
only 16K Bytes ot memory. In order to expand this address 
Port lines, 7nF5 and VA15 < location sOG©0,_ bits 0 and l^ 
the most significant bits ot the VIC address. tssentia.l ly -th 
select which ot the tour 16k banks ot memory T he Vi c ca n loo k at 
these port bits are INVERTED, that is, setting VA14 and VAi§'hIGH 


The 

ot the 

ONLV 

ot addressing 
s p a.c e , t m.i o I / 0 
«*r e used to form 
iese two bits 

Note the. 
will 


ot memory the 
is, setting *vA14 

cause t he VI C to acce ss t he LOW 16k blockout memory from . 

'7mT 4 low end VA 15 high will **lthe second 16K blnrL- 
5?FrF) ' *Tc. The Chere.cter ROM i* OQ. ly *' ulabl « *o the Vic'rhir' ir, Berk 0 
Vi000e-S3FFF;:. end Bank 2 ■: iOOOO-^SrFF.' ^nd *PP**rs i n th^q.F* 

o-i- two trunks. In order '' h ^- -i" c ^- i - to A ' r -^'s the rh^icter ROM, 

toi *s CB 1 3 * r , d C812 in the CHARACTER BhsE REklbTER ** th. *1* 

must be set ■fee *. ^tieuur ****** should b* 


V. 


to* set hioih <i>. N ,that- *he VIC will not be- 
of RAM which th* Ch*r*<-t*r ROM displaces. For tho-r^ 
the- VIC chi,:. fftu it e.cceis & +uU l6K By ?* s °* or 

access 
Bank 3 
these banks. 


The VIC <Register 

-= *?t 1 niu i] 0 *j .=,nd uBl— - k- 


to 


access the 


4K By*** 


1BK Bytes of 

RAM in this 4K tot ock of the desired benk, e*nk 
^COO.I'-SFFFF •> 1 d S'4 used, es the '-her- 


• • «■ V * * # 
**r--Ucations if whl '- 


~on some reason 


mus* 


1 ',s4O.-t0-srFFr.' or 

ROM is , ;J i 1 - d lf ' 


y' 




^ MU- ** ex '' 










•« 













Procf'aScr sees: VIC ir*?; : 



Th:- VBP 7:'r-:k.?:iir will e.u tom.at ice. I l y herdle the b.?nk sw i tch i n*:< 
n- 1:'7 into -h*? RAM* underneath the SASIC end VSR ROMs, 


-•-n I s-ne.t i or. ot c frT.:-: n c :-rtr i d-:je l ines : 


Pin *, 007 CLOCK- This l in* ' is the S. IS Mhr video dot clock trom which 
o.l l system t i m i n*:« i s der i ved. ' 

.Pin 7. I/O .PI— This is ■=-. negative active chi?:- select for the block .-<t 1 

memory -from sQEOO-sOErr Bytes>. 

Pin lb- I/u w2- This is a negative active chip select tor the block nf 
memory trom s0F00— s QFFF \256 Bytes >. 

Pin 11- R0ML- This is e. ne*:«e.7i ve .active chip select tor the block ot 
memory -from s:=:000-x*3FFr <SK Bytes>. This is true tor~*-iv 
COMMODORE—o4 memory mers, including ULTIMA/;. Any certr 
ROMs which er e to eppeer in the sOOOO block VE-P . 1-7,- > ’ l ^ 
heve their CS ?>in connected to this line. 


Pin 12, 


5-A- This is the SUB AVAILABLE si-line. I -from -he VIC chi 
line will low three cycles be-rore the VIC t.jkes 
system busses end re me. in low until VIC is t ini shed 
d i sp l e.y i n tor met: i on • 


r. 7h 1 s 
over the 
tetchin^ 


Pin 1 ; 


r i n =• 


DMA— This line e.llows external devices.- such es the - 
microprocessor certr id-:*eto tek.e control or" th* ’ I 
busses. When Pulled low, the address bus. *d.ate.~ bu-' -T*! 

R.-'W line ot the 67 10 processor ere Tri-?trt*. : i. " -2'.’7 , r; " A 
should only be pulled l ow when the 02 dock i? l.-.m*"*' ^ ^ 

In addition.- the VIC chip will continue to • 

DMA, there tore the external device must con tor m”-'" ** S}>X *& 
timing. This line is- pulled-u?:- on the CCMMO.QCR^ri 

- "niseis =*• neuety -e acty.,* cry* select tor . 

- - crr * S» v - rc-r all iIOMMODOP w : " 1: 

r-. r -r- i :ltT|Mc- •"*. r “em.:r 

* * w •' •• - • m^:. # , . . . 

the o locu wl:! ~ 


“he VIC 


- r-v— 


■ o m - A 000 — s S P; 

•xcept tor the ULTIMA/; me.*:-. 


ot me:,. 
». r.»: s 


neu.ety.-e ecty*e 


in z’ *tes.' 


•hip selec- -or ... 

An*- - - =.;-; :;:ir RCM.s wr,. 7\7 r,,4riV:r * 

in niece SASIC shouy 7 *7 tli''• e 

- v.7:M«ua“* « 

’‘-s-.ve the Co Pin t * -... . ‘ •- r -e 


IS a 

sEOOC-sp-rr 
1 n trie S A 0 0 0 b 1 o C k. 

pin - ; , thl . line _ , . .^ 

in the SECCO block should ne.ve the Co Pin t ; 


An-- 


th i s 


e. 
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*-*FTWhR:E hPF'LICFlTI i~i M 
MOTE 1001 


Huthors s Joe McEr;.erney, Eric Cot-ton, and Bill Hindortt 
Sub..i •=•«— ~fc = Sprite Movement 


T*=• 1 •=■ ± ■=: ± r-i :=.-fc-=*J-icJ.=.j~c4 s This 

explains sprite movement tor both PRL arid NTSC 
II chip. 


Application Note 
versions ot the VIC 


x - m o vement -s.j--.--j :=•=: comprre 


A. X MOVEMENT 


1. Abstract: 


a sprite 
on the 
•is $1F8 



—xposition - MVSX: Th® -^o 1 louring n’rals with x 
sprites expanded or- unexpended* in x on NTSC television 
.sr,d/or sprites unexpended in x on PAL systems. 


Movement of 
systems. 


a. Flow chart: 


3 / 25/ ! = !2 


Commodore 


psvge 1 




<lttVSX> 



1 000 
1010 
1020 
1030 
1040 
1050 
1 060 
1070 
1080 
1090 
1 1 00 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1188 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 


b. Program listings! 

1) Source: 

.PAGE 'MVSX' 

;CONSTANTS 
SP0X =*0000 
MSIGX =*0010 


*=*2000 

MVSX ASL A 
TAV 
TXA 

ADC SP0X,V 
STA SP0X,V 
TXA 

BMI MVSX2 
BCC MVSX1 
MVSX0 TVA 

LSR A 
TAV 

LDA MSIGX 
EOR PWR2,V 
STA MSIGX 
RTS 


MVSX 1 
MVSX2 


BCC MVSX0 
RTS 


;START OF SPRITE X,Y POSITIONS 
• VIC REGISTER CONTAINING X MSB'S 


•. Y=2*SPR# 

;.ft=2''S COMPLEMENT OFFSET 


• 2'S COMPLEMENT OFFSET<0o 

•HO CARRY FROM ADC ABOVE... s 0 fvtt 

• CORRECT THE MSB OF SPRITE X-rmpn 

•.R=INT < •A/2> " 

V=.A 

•MSIGX IS VIC REGISTER OF X MSB'* 

;PWR2 IS A TABLE OF THE POWEF:S OF 1 


PWR2 
• END 


BYTE *01,*02,*04,*08,^10'* 20 ' * 40 '*80 


8/25/82 


Co mm odor •*=* 














9 


2) Hex dump (as assernb led at $20005 : 


35 


2000 

0fl 

AS 

Sfl 

79 

00 

D0 

99 

00 

DO 

Sfl 

200fl 

30 

0F 

90 

0C 

98 

4fl 

AS 

flD 

10 

D0 

2014 

59 

IE 

20 

SD 

10 

00 

60 

90 

FI 

60 

20 IE 

01 

02 

04 

08 

10 

20 

40 

80 




Data statements <as assembled at $20005: 


1000 data 10,168 , 138 ,121,0, 208 , 153, 0 ,208 , 138 
1010 data 48,15,144,12,152,74,168,173,16,20S 
1020 data 89,30,32,141,16,208,96,144,241,96 
1036 data 1,2,4,8,16,32,64,128 


c. Memory/Register requirements: This routine requires 38 
<$265 bytes of memory, including 8 bytes -for the table of the 
powers - of—two <PWR25. It uses the accumulator and the x and y 

registers. 

d. Worst case execution time is 55 <$375 cycles <53.90 
micro-seconds5. 


2. Exposition - UNIMVX: This section deals with x movement of 
sprites expanded or unexpended in x on NTSC or PflL television 
systems. UNIMVX operates the same as MVSX insofar as the accumulator- 
must first be loaded with the sprite number <0 through 75 and the y 
register with the two r s complement offset. However, because this is 
a universal <NTSC or PflL5 x movement routine, there must also be a 
routine to check on which television system the routine is being 
used and then communicate this information to the UNIMVX subroutine. 
Because the NTSC system is based on 262 raster lines per screen 
whi le the PflL system is based on 312, the presence of.la raster 263 
<or greater5 would imply the PflL system. Thus we include TVSTO 
which checks to see if a raster line greater than 264 is scanned. 
■'Raster 264 is used as the compare value instead of 263 to insure 
that the correct system is chosen.5 If the raster passes 264, then 
the PflL system is in use; otherwise, the NTSC system is. To 
communicate its finding"to UNIMVX, TVSTD stores the high and low 
bytes of of the first illegal x position for the system in the 
variables MODH and MODL, respectively: TIPS for the PflL and $200 for 
the NTSC. 



- _ . . __ ' — A KJ S LU 1 1 ILIA V A * 

with ^The second routine, ATVNX, does 

the RHM MSB s back into MSIGX. It should be 


It copies 
all of 


does the oppose-a; 

"■=• — . , , - . —' Arn;o nsxux. x t snw ■« »- Aw-uted after 

the -t' f 1 x Positions have been updated. 

1 ' the user must follow this- procedure: Execute TVSTD 

,. T HMX once each a.t the begining of the Then, ^ery time 

fio«...«ed in the x direct ion: 1 •• Lo.=d the ar.-iimul=itor 
the 25Load the x register with the two ; s' 

nt u+'ts»-t , .a.-, i iwtmuv ,1 m beck _ . . 

i+ more 


and ■ . , 

. ,-prite is to be 

'■i+h the sprite number 

Mil • ' 1 . _ r r _ . 1 • •• —- •• ■» 

offset. 35Execute UNIMVX. 45 Loop back to step 
updated. 55Execute VTflMX. Section 


c0r,,, -‘+.iT*r-e to be 


*pr 


III. B. of 


* ,- 25 /S 2 


C o m mo d o r e 


Pag© 3 




"this flpp lication No*te -for an example using UNIMVX. ) 


b. Source 1 i st i ng s 


1000 

• PRO ' 

IJNIMVX' 


1010 

• 



1 020 

;VARIABLES: 

• 

1030 

*=$0010 

,*0R SOMEWHERE IN PG 9 

1040 

OSH 

*=*+i 

;OFFSET HIGH 

1 050 

OSL 

*=*+i 

}OFFSET LOW 

1060 

MODH 

*=*+i 

;MODULUS HIGH 

1070 

MODL 

*=*+1 

MODULUS LOW 

1080 

TX 

*=*+i 

;TEMP X 

1080 

TA 

*=*+i 

;TEMP A 

11.00 

srise 

*=*+8 

;AUXILIARY SPRITE MSB BYTES 

1110 

m 

r 


1120 

;CONSTANTS: 


1130 

V IC 

=$0000 

;START OF VIC CHIP 

1140 

SP0X 

=$0000 

;SPRITE 0 X-COORD LSB 

1150 

MSIGX 

=$0010 

SPRITE X-COORD MOST SIG BITS 

1160 

RASTER 

=$0012 

;RASTER LSB 

1170 

• 



1180 

*=$2000 


1180 

/ 



1200 

/ 



1210 

■ 

/ 

TELEVISION STANDARD CHECK 

1220 

; SETS 

UP HIGH AND LOW BVTES OF MODULUS <MODH,MODL) 

1230 

• 

/ 

ACCORDING TO 

T.V. STANDARD IN USE: 

1240 

; NTSC: $200 

PAL: $1F8 

1250 

r 



1260 

TVSTD 

SEI 

;DISABLE IRQS 

1270 


LDX #$01 

;SET UP PAL MODULUS MSB 

1230 


LDV #$F8 

;SET UP PAL MODULUS LSB 

1280 

TVSO 

LDA VIC+$11 

LOOK AT RASTER MSB. IS IT A 1 o 
;IF 0 THEN RASTER < 256. SO LOOK AGAIN 

1300 


BPL TVS0 

1310 

TVS 1 

LDA #$08 

;RASTER > 255 ...BUT... 

1320 


CMP RASTER 

;IS IT GREATER THAN 264 o 

1330 


BCC TVS2 

r IF YES THEN BRANCH. TV STD -pa. M 

;IF NO THEN CHECK FOR MSB OF PA^TFP'- i 
} IF YES THEN GOTO TVS1 KH-..TER - 1 

1340 


LDA VIC+$U 

1350 


BMI TVS1 

1360 

1370 


LDX #$02 

LDV #$00 

'SET UP NTSC MODULUS MSB. TV STD = NTSC 
,-SET UP NTSC MODULUS LSB 

1380 

TVS2 

STX MODH 

;STORE IN MODULUS FOR FUTURE USE 

1380 


STV MODL 


1400 


CL I 


1410 

1420 

• 

r 

RTS 


1430 

/ 



1440 

1450 

/ 

a 

/ 

UNIVERSAL MOV 

■'E SPRITE IN X DIRECTIONS 

1460 
1470 

• 

; A REG = SPRITE NO. 

X REG = OFFSET <2'S COMPLEMENT FORM) 

1430 
1480 

1 500 

• 

IJNINVX 

STX TX 

STX OSL 

;PROTECT X 
;SET UP OFFSET LOW 


o /82 


Commodore 


r :i a.^e 4 





1510 


. TAX 


1520 


• ASL 

A 

1530 


TAV 


1540 


LDA 

#0 

1550 


STA 

OSH 

1568 


CLC 


1570 


LDA 

OSL 

1580 


BPL 

UMX0 

1590 


EOR 

#*FF 

1600 


ADC 

#1 

1610 


STA 

OSL 

1628 


SEC 


1630 


LDA 

MODL 

1640 


SBC 

OSL 

1650 


STA 

OSL 

1660 


LDA 

MODH 

1670 


SBC 

OSH 

1680 


STA 

OSH 

1690 


CLC 


1700 

UMX0 

LDA 

SP0X,Y 

1710 


ADC 

OSL 

1720 


STA 

SP0X,Y 

1730 


LDA 

SMSB,X 

1740 


ADC 

OSH 

1750 


STA 

SMSB,X 

1760 


SEC 


1770 


LDA 

SP0X,V 

17S0 


SBC 

MODL 

1790 


STA 

TA 

1S00 


LDA 

SMSB,X 

1810 


SBC 

MODH 

1S20 


BCC 

UMX 1 

1830 


STA 

SMSB,X 

1840 


LDA 

TA 

1850 


STA 

SP0X,Y 

I860 

UMX1 

TVA 


1870 


LSR 

A 

1880 


LDX 

TX 

1890 

1908 

• 

/ 

RTS 


1910 

m 

/ 

TRANSFER 

1920 

/ 



1930 

ATVMX 

LDX 

#7. 

1940 

ATV0 

LDA 

SMSB,X 

1950 


LSR 

A 

i960 


ROL 

MSIGX 

1970 

i960 


DEX 



PPL 

ATV0 

2000 

e 

/ 

RTS 


2010 

/ 

TRANSFER 

2020 

2030 

m 

•i/TAMX 

LDX 

#7 

2040 

iT-i 0 

VTA0 

LDA 

LSR 

MSIGX 
SMSB,X 


ASL 

A 

2 060 




:/25/S 

Cm 




;A=X 
;A=2*A 
; V=A 

;CLEAR OFFSET HIGH 

;CLEAR CARRV FOR LATER 
>CHECK FOR NEGATIVE OFFSET 
;IF POSITIVE THEN BRANCH 
;PERFORM 2-'S COMPLEMENT OPERATION 

jPUT RESULTS IN OSL AND THEN 
;FORM THE MODULAR COMPLEMENT OF 
✓•THE OFFSET BV SUBTRACTING IT 
;FROM THE MODULUS 

;PAL 504 , NTSC 512 


;ADD OFFSET TO SPRITE X 
;C SMSB+X,SP0X+V 3=... 

; ...C SMSB+X,SP0X+V3 + C OSH,OSL 3 


; IS THE SUM >= MODULUS' 5 
}CHECK BV SUBTRACTING 

;CATCH FOR LATER USE 


;IF SUM < MOD THEN EXIT 
;OTHERWISE CORRECT X-COORD 


;RESTORE A REG 
;RESTORE X REG 


TRANSFER SPRITE MSB BYTES TO MSIGX BITS 


TRANSFER SPRITE MSIGX BIT* rn n.-r- 

1 Tl -‘ Mae BYTES 


Commodore 


pa.*ie 5 






. END 


2070 

2080 

2090 

2100 

2110 

2120 

2130 


ROL SMSB,X 
DEX 

BPL VTR0 
RTS 


B. X COMPRRE 


1. Rbstract: This routine checks +0 see it any 
sprite is in the viewable region of the screen. The 
be loaded with the sprite number <0 through 7> prior- 
time the carry -flag indicates the answer. It carry =1 
sprite is on the screen; it carry=0, then the sprite 


bit ot a giyen 
accurnu lator mus 
to use. Rt RTS 
r then the 
is ott screen. 


t 


2. Exposition: The following exposition deals with x 40 column 
window compare ot sprites unexpended in x on NTSC or PRL television ' 
systems. Section I. B. 3. explains how this routine may be modified 
tor sprites expanded in x. 


a. F low chart 



sponx 1 > 


8/25/32 


Commodore 


re/ye 6 


















b. 0igrains: The following diagrams illustrate the on end 
ott screen areas tor a sprite. Figure la is -for NTSC systems arid 
■figure lb is -for PftL. In each, the top hal-f shows the case -for 
sprites expanded in x, whi le the bottom shows the unexpended case. 
If the SF’ONX (or SQNXX for exp. sprites) is called with the sprite 
in the on-screen area, carry would be set upon returning. If called 
with the sprite is entirely in the off—screen area, carry would be 
c lear. 


f i gure 1. G O M R* FA R: EE 


f i gure 1 a. M T :=: C 


on;c=l 

* 


*1E90x 0*1FF *00x0*17 


off:c =0 
' x =0 


on:c=l 


*10x0*17 


4 


4 


EXPANDED 
on: c =1 


*180x0*157 


SCREEN 

<VIEWABLE REGION) 


on: c=l 


* 180x0*157 
UNEXPRNDED 




■> 


off:c =0 
< -> 


*1580x0*1E8 


4 


off:c =0 


*1580x0* IFF 


figure lb.- F'Hl_ 


on:c =1 


«-- > 

*1E 10 x 0 * 1 F7a *80x0* 17 


note: *1F3-*1FF 
do not exist 
on PflL 



EXPANDED 
on: c =1 

off:c =0 

*130x0*157 

* 1 580x0*i £0 

SCREEN 

(VIEWABLE REGION) 


on: c =1 

off:c =0 

*180x0*157 

UNEXPRNDED 

4- —--> 

*1580x0*1F7 






Commodore 



























c. Pro'iir-am listing as assemb led at $2000: 
1> Source: 

;UNEXPANDED 


1000 .PAGE •'SPONX' 
1010 ; 

1020 ;CONSTANTS 
1030 SP0X =$0000 
1040 MSIGX =$0010 
1050 ; 

1060 ; 

1070 $=$2000 


1030 

• 



1090 

SPONX 

TAX 


1100 


ASL 

A 

1110 


TAV 


1120 


LDA 

MS I GX 

1130 


AND 

PWR2,X 

1140 


BNE 

SPONX1 

1150 


LDA 

SP0X,Y 

1160 


BEQ 

SPONX0 

1170 


SEC 


1130 

SPDNX0 

RTS 


1190 




1200 

SPONX1 

LDA 

#$57 

1210 


CMP 

SP0X,Y 

1220 


RTS 


1230 

/ 



1240 

PWR2 

.BYTE $01 ,i 

1245 

r 



1250 

• END 




;START OF VIC X,Y POSITIONS 
;VIC REGISTER CONTAINING X MSB'S 


;AT START .A SHOULD CONTAIN SPP# 
;THE CARRV FLAG IS CLEARED 
;. V=2$SF‘R# 

r MSIGX IS VIC REGISTER OF X MSB^S 
;PWR2 IS A TABLE OF POWERS OF 2 
.jIF X>$FF THEN CMP LOW ORDER PART 
;SEE IF 8 LSB'S OF X ARE ZEROS 
;IF X=0 THEN EXIT 

; ELSE IF 0<X<$FF THEN SET CAPPV 
,-EXIT 

;X>$157? <$157 IS LAST X ON SCREEN> 
;THE CARRV FLAG IS UPDATED 


2) Hex dump <as assemb led at $2UUUi: 

.:2000 AA 0A A8 AD 10 00 3D IS 20 DQ 

.:£00A 07 B9 00 DO F0 01 3S 60 AS 57 

. : 2014 09 00 D0 60 01 32 04 03 10 20 

.:201E 40 SO 

3> Data statements <as assemb Wd at $2000}. 

1000 da.ta 178,10, l73 ' 16 ' 2 ® S : 61 '^ 4 ' 3 2,20S 
1010 data 7,185,0,203,240,1,56,96,169,8? 

1020 data 217,0,208,96, 1 ,■=-,4,S, It.,32 
1030 data 64,123 

. „ .. Memory/Reg i star r-egu i rements : Th i s rout i ne regu i res 32 

<$20, bytes of memory, including 8 byte* for the table of pomers-of 
two <PWR2>. It +} ., e accumulator the x and y registers. 

e. Worst case execution time is 31 <$1F> cycles <30.38 
rri icro-seconcJs> . 


Modification ter Expanded Sprites: This routine must be 


3 / 25 / 8 ^ 


Commodore 


P-s&g 8 


modified if if is to be used with 
following routine, SONXX, is SPON 
expended in x on NT SC television : 


is to be used with e sprite expended in x. The 
ine, SONXX, is SPGNX rewritten for use with sprites 
on NTSC television systems. Its use is identical to 


that of oPQNX. To use this with a PRL VIC chip, change line 1180 
from CMP ^ EE Z6 4 to OMF* 1 . 


1000 .PAGE 'SONXX' 
1010 ,• 


EXPANDED 


1020 ;CONSTANTS • 


1030 SP0X =$0000 
1040 MSIGX =$0910 


,• START OF VIC X,V POSITIONS 
;VIC REGISTER CONTAINING X MSB'S 


1040 MSIGX 
105© ; 

1060 ; 

1070 *=$2000 
1030 ; 

1090 SONXX 


TAX 
PSL A 
TAV 

LDA MSIGX 
AND PWR2,X 
BEQ SONXX0 
LDA SP0X,V 
CMP #$58 
BCC SONXX0 
CMP #$E9 
RTS 


;AT START .A SHOULD CONTAIN SPR# 
;THE CARRY FLAG IS CLEARED 
;.Y=2*SPR# 

;MSIGX IS VIC REGISTER OF X MSB'S 
;PWF^2 IS A TABLE OF POWERS OF 2 
;IF X<$FF THEN SPR ON SCREEN 


1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1130 
1130 


ELSE IF X<$153 
THEN SPR ON SCREEN 


OTHERWISE, .IS X=>$1E3? 
EXIT 


1200 ; 


1210 SONXX0 

1220 

1230 ; 

1240 PWR2 
1250 ; 

1260 .END 


SEC 

RTS 


;X>$157? C$157 IS LAST X ON SCREEN> 
;EXIT 


BYTE $01,$02,$04,$08,$10,$20,$40,$80 


a- Hex dump <as assembled at $2060): 

. :2008 RR as RD 10 D0 3D 17 20 F0 

. : 200R QR 89 80 D0 C9 53 98 03 C9 E3 

. :2014 60 33 60 01 02 04 83 10 20 40 

••201E 30 

b. Data statements Cas assemb led a.t $2880> : 

1000 data 170,10,168,173,16,283,61,23.32,240 

1010 data 10,185,0,208,201,33,144,3,281,23°' 
1028 data 96.56-96,1,2,4,3,16,32,64 
1030 data 128 


4. NOTES: 



The changes below modify .. 

sprite is on screen but 
r source listing.> 



L.offifriodor* 






1> Sprites unexpanded in x 


a> change 
b> delete 
c > change 


line 1160 from 
l ine1170 
line 1200 from 


Sprites expanded in x: 
a> change line 1160 from 
b> delete line1170 
c> change line 1200 from 


BEQ SPONX0 to CMP #$18 
LDfi #$57 to LDfl #$40 

BEQ SPONX0 to CMP #$18 
LDfl #$57 to LDfl #$28 


to know if any part of a 
an edge, such as the case 
the screen. The changes 


b. Sometimes it is more useful 
sprite is entirely on screen but not at 
when a sprite is to be kept confined to 

below modify SPONX in this regard: carry is cleared if the sprite is 
all or partially offscreen .=.r- if it is at either the left^or right 
edge. Care should be taken when the movement offset is greater than 
1. The sprite could jump over an edge and flag the user onTy-fter 
the sprite is all or pa/'tially off screen. If the offset is * 

however, this will not happen. <Again, line numbers refer to the 
source listing. > o -cn. 

1> Sprites unexpended in x: 

a> change line 1160 from BEQ SPONX0 to CMP #$19 


b) de lete 
c> change 


linel170 
line 1200 


from LDfl #$57 to LDfl #$3 F 


2> Sprites expanded in 

a) change line 1160 

b) delete linel 170 

c) change line 1200 


x: 


from BEQ SPQNX 0 to CMP #$19 
from LDfl #$57 to LDfl #$27 


I I 


M O E M EE M T cJ V O M R- r, r . 


fl. V MOVEMENT 
B. V COMPARE 


together in one routine 



screen. The subroutine below works on n, sc il i«.i«ion 

sy*t*,„* Oniy Hiuht modification is If." 1 - « 

monk with Britos expanded in y. th * " M 


~~ ’ Ex Pos i t i on : 


J/25/S2 


Commodore 


page 


10 



LlIXClOIIZIQLlIQ 


a. F low char t 


< rnvsy > 

ftSL ft 

TftX 

TVfl 

ftDC SP0V,X 
STft SP0V,X 
CMP.#*10 

spy<SID 

/ r.n.A 



N ' \ 

LDfl #$F9 

CMP SP0V,X 
RTS 

> 


b. Diagram: Figure 2 below shows the ranges 
positions for which the sprite is on-screen <carry=l 
<carry=0>. 


t 

off: c=0 
*0<=y<=SlD 
4/ 
t 

on: c=1 
$lE<=y<=$31 


f i gur e2. V O O M F* Fl F: FT 


IJ 

H 


:c 


on: c=1 
$32<=y<=$F9 


X. 


SCREEN 

<VIEWABLE REGION} 


0 -f-f: c 



=0 

*FF 


q/25/ 82 




•9*;- 


: .H. • 




of sprite y 
or off-screen 


r 

off: c=0 
*0<=y<=$3 

on:c=l 
$9<=y<=$3i 

>/■ 


on: c=1 
f9<=y<=SF9 


°ff;c=0 

^FR-CsyO^pp 

I 


Pag© i j 



Corfimodor^ 


omoxz'-uxm 














•Program listings 


1> Source: 


1 0010 

• PAGE 

CO 

51 

V' 

1010 

9 

r 



1020 

; CONS' 

TANT 


1 030 

SP0V 

=SD001 

1 040 

r 



1050 

*=*2000 


1060 




1070 

M'v'SV 

ASL 

A 

1080 


TAX 


1090 


TYA 


1100 


ADC 

SP0Y,X 

1110 


STA 

SP0Y,X 

1120 


CMP 

#$1D 

1130 


BCC 

MVSVO 

1140 


LDA 

#$F9 

1150 


CMP 

SP0V,X 

1160 

MVSY0 

RTS 


1170 

■ 

/ 



1180 

. END 




;START OF SPRITE X,Y POSITIONS 


;RT STRRT .A SHOULD BE LORDED WITH SF’R# 
;.X=2*SPR# 

;OFFSET MOVED INTO .fl 
;OFFSET IS RDDED TO SPR 
;SUM IS NEW V POSITION 
;IF Y<$1D THEN C=0 
; <AND BRANCH TO EXIT) 
t ELSE IS Y>$F9? CLAST 
:CARRY IS UPDATED ACCORDINGLY 
? EX IT 


V POSITION 


V ON SCREEN> 


2> Hex dump Cas assembled at $2000): 

. : 2900 0A AA 98 7D 01 00 9D 01 D0 C9 
.:200A ID 90 05 A9 F9 DD 01 DO 60 

3.' 1 Data statements C as assemb led at S2000> • 

IDO© data 10,170,1-52,125,1,208,157,1 op.* .. ni 

1010 data 29,144,5,169,249,221,1,20 q's6 01 




d . 

Memory/Re 

•lister r 

CS13> by 

tes 

ot memory 

es we 11 

re *15 3 

L ster 

S B 





e • 

Worst ees. 

e execut 

<3G. 

,38 m 

i ere 

i-seeonds } 

• 



•f. 

Limitations: This 

is i 

in 25 

row 

mode ard 

that th- 

C un 

less 

the 

routine h 

3 ^. been - 

be 1«: 







■3. 

I f th i s r- 

out i ne i: 


19 


* v 

' Mach i ne eye l©-- 


routine assume 4 -u . 
e sprite in ciu<=.VIC II 1 ^ 
changed as T-p 100 is ^^©XRanded if 
f '-‘- lf !®d i n section g 


1i. If this routine is to be used with . , .... in 

y, then change line 1120 of the editor listi r .-< T'.' f 1 tes expand*^- ^ c , 
to •—-MR* tt ^ . This eha/’ige is epp \ i eei*. i ^ urrt ^ I “1 ^ ^ 

sprites on either NTSC or PAL television •?.".!+1 using y-e.-f-- 

— Tiler 




3. NOTES: 


S/25/32 
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page 12 


lf 4 , #e t ,.<r4 'l u 














a. The changes below modify MVSY to set carry on ly if the 
*=.r-i-+: ± r—•=- sprite is on screen, tout clear it otherwise. (Line 
numbers refer to the source listing.> 

1}* Sprites unexpanded in y : 


a> 

change 

l i ne 

1120 

from 

CMP 

#$1D 

to 

CMP 

#$32 

c> 

change 

line 

1140 

from 

LDR 

#$F9 

to 

LDR 

#$E5 

Spr 

a> 

^ites expanded in 
change line 1120 

y s 

from 

CMP 

#$1D 

to 

CMP 

#$32 

c> 

change 

line 

1140 

from 

LDfl 

#$F9 

to 

LDfl 

#$00 


b. Sometimes it is more useful 
sprite is entirely on screen but not at 
when a sprite is to be kept confined to 
he 1ow modify MVSY in this regard: carry 
all or partially offscreen cm 
edge. Care should be taken if 
The sprite could Jump over an 


sprite is 
this will 
listing.> 


to know if any part of a 
an edge, such as the case 
the screen. The changes 
is cl eared if the sprite is 
~ if it is at either the top or bottom 
the movement offset is greater than 1 . 
edge and f lag the user on ly after the 


all or partially off screen. If the offset is 1, however, 
not happen, (Again, line numbers refer to the source 


1> Sprites unexpended in y: 


1> Sprites expanded in 
a> change line 1120 
c> change line 1140 


from 

CMP 

#$1D 

to 

CMP 

#*33 

from 

LDR 

#*F9 

to 

LDR 

#*E4 

y s 

from 

CMP 

#*1D 

to 

CMP 

#*34 

from 

LDR 

#*F9 

to 

LDfl 

#*Cf 


XXI 


e:~:fim f-les 


A. EXAMPLE 1 

The example be low uses all three main subroutines presented in 
this Application Note. Its purpose is to demonstrate the use of the 
routines in an actual program. When executed, this program will 
bounce an unexpended sprite around the screen on either television 
system. The MVSX and MVSY subroutines move the sprite until it i^ 
entirely off the screen (as indicated by SPONX or MVSV>. If, after 
moving the sprite in the x direction, the x compare indicates that 
sprite has gone off screen, then the x direction is reversed 
The same is true for y movement. 

By modifying the subroutines as explained elsewhere in +hi- 
. „ 4 -^ the exa- r -*:* le car be made to work nth an e w •: a- :ied i +& ~ 

lines 1250 and 1260 o-P the example if an expanded sprite is 
to be used). 

NOTE: 

The subroutine WRIT has been has been add*-! 

• •ample and thus better enable the programmer ‘r 1 

«* This ctelay I.:..:.,:- lasts for about 26668 

*>::*<-uti- .about 20.25 milliseconds. ne ' 
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1000 . PAGE •' EXAMPLE 1' 
1010 ; 

1020 *=*0002 
1030 SW1 *=*+1 
1040 SW2 *=*+1 
1G50 ; 

1060 ,* CONSTANTS 
1070 SP0X =*0000 
1080 SP0V =*0001 
1090 MSIGX =*0010 
1100 SPENA =*0015 
1110 YXPAND =*0017 
1120 XXPAND =*00ID 
1130 ; 

1140 ; 

1150 *=*2000 


1160 ; 

1170 EXAMP 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1258 
1260 
1270 
1280 
1290 ; 

1380 EXAMP0 

1310 

1320 

1330 

1340 

1350 

1360 

1370 

1380 

1390 

1400 y 

1410 EXAMP1 

1420 

1430 

1440 

1450 

1469 

1470 ; 

1480 EXAMP2 
1490 

1500 
1510 ; 

1520 ; 

1530 EXAMP3 



LDA #*18 
STA SP0X 
LDA #*32 
STA SP0Y 
LDA #$01 
STA SPENA 
LDA #*08 
STA MSIGX 
STA XXPANO 
STA VXPAND 
STA SW1 
STA SW2 

JSR WAIT 
BIT 3W1 
BMI EXAMP1 
LDX #*01 
LDA #'*00 
JSR MVSX 
LDA #*00 
JSR SPONX 
BCS EXAMP3 
BCC EXAMP2 

LDX #*FF 
LDA #*00 
JSR MVSX 
LDA #*00 
JSR SPONX 
BCS EXAMP3 

LDA SW1 
EOR #*FF 
STA SW1 


BIT SM2 
BMI EXAMP4 
LOV #*01 


5/02 


;SWITCH 1: *0=RIGHT, *FF=LEFT 
;SWITCH 2: *0=OOWN, *FF=UP 


;SPRITE #0 LSB'S OF X POSITION 
,’SPR#0 V POSITION 
;VIC REGISTER CONTAINING X MSB'S 
y SPRITE ENABLE REGISTER 
;V-EXPANSION REGISTER 
;X EXPANSION REGISTER 


;INITIALIZE SPRITE 8 
y INITIALIZE X P0SITI0N=*18 

;INITIALIZE V P0SITI0N=*32 

;ENABLE SPRITE 0 

,-SET X MSB TO 0 
;NQ X EXPANSION 
;N0 V EXPANSION 
INITIALIZE TO "RIGHT" 
y AND "DOWN" 


;A 20662 CYCLE DELAY 
IF HIGH BIT SET 
; THEN MOVE SPRITE LEFT 
; ELSE MOVE IT RIGHT 1 PIXEL 
;0 INDICATES SPRITE 0 
y MOVE THE SPRITE 


'SEE IF ANY OF THE SPR STILL ON SCREEN 
; THEN BRANCH TO MOVE I IP/DOWN 
; ELSE REVERSE X DIRECTION"first 

;MOVE SPRITE LEFT 1 PIXEL 
;0 INDICATES SPRITE 0 
; MOVE THE SPRITE 


,ir nm ui- I Hh bPR ST III nu 
; THEN BRANCH TO MOVE up™ 0l ^ REEN 

'• ELSE REVER$E X 01 RECTI ON FIRST 


high bit set 

; THEH BRANCH to MC-f 
I ELSE MOVE I T 


SPRITE UP 
PIXEL 
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1568 


LDfl 

#$00 

• ;0 IHDIGATES SPRITE 0 

1570 


JSR 

MVSV 

;MOVE THE SPRITE 

1580 


BCS 

EXRMP0 

;IF SPR ON SCREEN THEN CVCLE RGRIN 

1590 


BCC 

EXRMP5 

; ELSE REVERSE V DIRECTION FIRST 

1600 

/ 




1610 

EXRMP4 

LOV 

#$FF 

;MOVE SPRITE UP 1 PIXEL 

1628 


LOR 

#$00 

y 0 INDICATES SPRITE 0 

1630 


JSR 

MVSV 

;MOVE THE SPRITE 

1640 


ecs 

EXRMP0 

,-IF SPR ON SCREEN THEN CVCLE RGRIN 

1650 

• 

r 




1660 

EXRMF'5 

LOR 

SW2 

; ELSE REVERSE V DIRECTION FIRST 

1670 


EOR 

#$FF 


16S0 


STR 

SW2 


1690 


JMP 

EXRMP0 

,• AND THEN START CVCLE RGRIN 

1700 

/ 




1710 

• 

y 




1720 

• 

y 




1730 

MVSX 

RSL 

fl 

. V=2*SPR# 

1740 


TRV 



1750 


TXfi 


;.fl=2'S COMPLEMENT OFFSET 

1760 


RDC 

SP0X,V 


1770 


STR 

SP0X,V 


1780 


TXfi 



1790 


BMI 

MVSX2 

;2'S COMPLEMENT OFFSETC0? 

1800 


BCC 

MVSX 1 

;NO CRRRV FROM RDC ABOVE...SO EXIT 

1810 

MVSX0 

T't'R 


;CORRECT THE MSB OF SPRITE X-COORD 

1820 


LSR 

fl 

} .fl=INT <.fl/2) 

1830 


TRV 


;.V=. fl 

1840 


LDR 

MSIGX 

}MSIGX IS VIC REGISTER OF X MSB'S 

1850 


EOR 

PWR2,V 

;PWR2 IS R TABLE OF THE POWERS OF TWO 

I860 


STR 

MSIGX 


1870 

MVSX 1 

RTS 



1880 

% » 

r 




1890 

MVSX2 

BCC 

MVSX0 

... 

1900 


RTS 



1910 

/ 




1920 

• 

y 




1930 

SPONX 

TRX 


;RT START .R SHOULD CONTAIN SPR# 

1940 


RSL 

fl 

} THE CRRRV FLAG IS CLEARED 

1950 


TRV 


;. V=2*SPR# 

I960 


LDR 

MSIGX 

; MSIGX IS VIC REGISTER OF X MSB'S 

1970 


RNO 

PWR2 , X 

; PWR2 IS R TABLE OF POWERS OF 2 

1980 


BME 

SPONX1 

;IF X>$FF THEN CMP LOW ORDER PRRT 

1990 


LDR 

SF'OX, V 

;SEE IF 8 LSB'S OF X ARE ZEROS 

2000 


BEQ 

SPONX0 

} IF X=0 THEN EXIT 

2010 


SEC 


; ELSE IF 0<X<$FF THEN SET Cflpp., 

2020 

SPOWX0 

RTS 


; EX IT ~ ' KV 

o f< "3 0 

• 




2040 

SPONX1 

LDR 

#$57 

;X>$157? C$157 IS LAST X ON c r r., cm 

2050 


CMP 

SP0X,V 

; THE CRRRV FLAG IS UPDATED " REEN> 

2060 


RTS 



2065 

y 




2070 

y 




2080 

MVSV 

RSL 

fl 

;RT START .fl SHOULD BE LOftncr- 



TRX 


;.X=2*SF'R# Ljh DED WITH SPR# 

Cm W — V 
2100 


T't'R 


; OFFSET MOVED INTO .fl 


/2S/82 


Commodore 


^=*••3© 15 




2110 


•ADC 

SP0Y,X 

;OFFSET IS ADDED TO SPR Y POS 

2120 


STA 

SP0Y,X 

;SUM IS NEW Y POSITION 

2130 


CMP 

#$1D 

;IF Y<$1D THEN C=0 

2140 


BCC 

MVSV0 

; -CAND BRANCH TO EXIT) 

2150 


LDA 

#$F3 

; ELSE IS Y>$F9? -CLAST Y ON 

2160 


CMP 

SP0Y,X 

}CARRY IS UPDATED ACCORDINGLY 

2170 

MVSV0 

RTS 


;EXIT 

2180 

• 

r 




2130 

m 

r 




2206 

WAIT 

LDX 

#$FF 

;WAITS 20662 MACHINE CYCLES 

2210 

WAIT1 

LDY 

#$0F 


2220 

WAIT2 

DEY 



2230 


BNE 

WAIT2 


224© 


DEX 



2250 


BNE 

WAIT1 


2260 


RTS 



2270 

• 

r 




22S0 

/ 




2230 

PWR2 

•BYTE $01,$02, 

$04,$08,$10,$20,$40,$80 

2300 

• 

/ 




2310 

. END 





IT I ON 


This example demo n s t r at e s the use o-f UNIMVX arid its auxi liarv 
subroutines. When executed, it will display a solid x—expanded 
sprite on the screen. In the upper—right corner ot the screen is 
shown the x position ot the sprite in hexadecimal notation." By” 
pressing the cursor-right key, the user can move the sprite right 
across <and around) the screen. Because the universal x-movement 
routine is used, this example checks tor the television standard 
used. Note that on a PAL television the sprite moves trom S1F7 to 0. 

NOTES: 

1> This example steps on zero page and contains the BPK 
'command. For these reasons it should be run trom VICMOn" <with an ' 
alternate zero page enabled). 

2) The user is advised to experiment with the routine bv 
changing the two's complement oftset in line 1£30 ot the source 
listing to ditterent values. 


1 000 
1010 
1020 
1030 
1040 
1050 
1 0E0 
1070 
1030 
1090 
1100 
1110 
1120 
1130 
1140 


.PAGE 'EXAMPLES' 

EXAMPLE OF UNIVERSAL SPRITE MOVE 
#=$0010 
;VARIABLES 


OSH 

OSL 

MODH 

MOOL 

TX 

TA 

SMSB 


:+:=+•+1 
.+:=*+i 
:+•=+:+1 
.+:=*+1 
*=.*+1 
*=*+1 
*=*+3 


•CONSTANTS 
SLSB=$0000 


;OFFSET HIGH 
SET LOW 
•MODULUS HIGH 

•modulus low 


;AUXILIARY SPRITE .MSB BYTES 
•VIC REGISTER SPRITE LSB BYTES 

Cortmocior^ 






1150 

MSIGX: 

=$0010 ;VIC 

1160 
1176 

VIC=$D000 

/ 


1130 

1130 

/ 

*=$C000 

1280 

EXAM2 

SEI 


1210 


LDX 

#$01 

1220 


LDY 

#$F8 

1239 

EX0 

LDA 

VIC+$11 

1240 


BPL 

EX0 

1250 

EX1 

LDA 

#$08 

1260 


CMP 

VIC+$12 

1278 


BCC 

EX2 

1280 


LDA 

VIC+$U 

1290 


BN I 

EX1 

1300 


LDX 

#$02 

1310 


LDY 

#$00 

1320 

EX2 

STX 

MODH 

1330 

1340 

1350 

1360 

1370 

r 

m 

f 

S7V 
CL I 

MODL 

1380 


LDA 

#1 

1390 


STA 

VIC+21 

1400 


STfl 

VIC+29 

1410 


LDA 

#$7F 

1420 


STA 

VIC+1 

1430 


LDA 

#$30 

1440 


STA 

$07F8 

1450 


LDA 

#0 

1460 


STA 

SLSB 

1470 


STA 

MSIGX 

1480 


STA 

SMSB 

1430 


LDX 

#62 

1500 


LDA 

#$FF 

1510 

1520 

EX3 

STA 

DEX 

$2000,X 

1530 

1540 

1550 

1560 

/ 

/ 

• 

* 

BPL 

EX3 

1570 

EX4 

JSR 

VTAMX 

1580 


LDA 

#0 

1590 


LDX 

#$0 1 

1600 


JSR 

IJNIMVX 

1610 


JSR 

ATVMX 

1620 


LDA 


1630 


LDY 

#0 

1640 


JSR 

BTH 

1650 

1660 
1670 
1630 1 
1630 
1700 

EX5 

LDA 

LDY 

JSR 

JSR 

CMP 

BEQ 

VIC 

#2 

BTH 
$FFE4 
#$ 1D 

EX 4 


REGISTER SPRITE MSB BITS 


;DISABLE IRQS 

,*SET UP PflL MODULUS MSB 

;SET UP PflL MODULUS LSB 

>LOOK AT RASTER MSB. IS IT A 1 ? 

;IF 0 THEN RASTER < 256. SO LOOK AGAIN 
>RASTER > 255 ...BUT... 

;IS IT GREATER THAN 264 ? 
r IF VES THEN BRANCH. TV STD = PAL !! 

;IF NO THEN CHECK FOR MSB OF RASTER = 1 
>IF VES THEN GOTO EX1 

;SET UP NTSC MODULUS MSB. TV STD = NTSC 
;SET UP NTSC MODULUS LSB 
;STORE IN MODULUS FOR FUTURE USE 


;ENABLE AND EXPAND SPRITE 0 


;SET SPRITE V POSITION TO 127 
‘SET SPRITE POINTER TO 123 
;CLEAR OUT SLSB , 3MSB & MSIGX 


;SET SPRITE TO SOLID BLOCK 

} NOTE:- IF SPRITE POINTER = 128 
; THEN SPRITE ADDRESS = $2000 


t TRANSFER MSIGX BITS TO SMSB BVTFo 
rLOAD A WITH SPRITE NO. 



rHEX CHARACTERS FOR OlSPLfl^r flSCIL 
: BI NflRV TO HEX < SCREEN flori T N TV 

"' LI1 - 1 CONVERTER 


;KERNAL KEY SCANNER 
;LOOK FOR ' CUROR-RIGHT' 
;IF ' CURSOR-R' KEY THEN 


KEY 

move 


SPRITE 


Q/d'Jf '- ,Cm 


1 7 
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AGAIN 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1730 
1730 
1300 
1310 
1820 
1830 
1840 
1850 
1S60 
1870 
1880 
1390 
1300 
1910 
1320 
1930 
1340 
1950 
I960 
1970 
1380 
1990 
2000 
2010 
2020 
2030 
2040 


CMP #$00 
SHE E/5 
BRK 
BRK 


;LOOK FOR. 'RETURN' KEV 
IF HOT DOWN THEN SCAN KBO AGAIN 
;IF DOWN THEN EXIT TO VICHON 


BTH 


CONV 


CON VI 


CONVERT BYTE TO TWO SCREEN HEX CHARACTERS 
PHA 

AND #$0F 

JSR CONV 

STA $0421,Y 

PLA 

LSR A 

LSR A 

LSR A 

LSR A 

JSR CONV 

STA $0420,V 

RTS" 

CONVERT NYBBLE TO SCREEN CHARACTER HEX 

CMP #10 
BCC CONV1 
SBC #9 
RTS 

ORA #$30 
RTS 


A 


UNIVERSAL 

REG=SF'RITE 


2050 

UNIMVX STX 

TX 

2060 

STX 

OSL 

2070 

TAX 


2030 

ASL 

A 

2090 

TAY 


21G0 

LOA 

#0 

2110 

STA 

OSH 

2120 

CLC 


2130 

LOA 

OSL 

2140 

BPL 

IJMX0 

2150 

EOR 

#$FF 

2160 

ADC 

#1 

O •< -rn, 

STA 

OSL 

2130 

SEC 


2190 

LOA 

MOOL 

2200 

SBC 

OSL 

2210 

STA 

OSL 

2220 

LOA 

MOOH 

2230 

SBC 

OSH 

2240 

STA 

OSH 

2250 

CLC 



MOVE SPRITE IN X DIRECTIONS 

NO. X REG-OFFSET <2'S COMPLEMENT FORM) 

;PROTECT X 

;SET UP OFFSET LOW 

; A=X 

;A=2:+:A 

; Y=A 

;CLEAR OFFSET HIGH 

;CHECK FOR NEGATIVE HFF-pt 
;IF POSITIVE THEN BRANCH 
^PERFORM 2'S COMPLEMENT OPERATION 

RESULTS IN O-SL Tu . u 
; FORM THE MODULAR nW' J ~ N 
; THE OFFSET BY SI iptc.-- LE f1EHT 0F 
;FR'OM THE MODULUS '^-TING IT 

• ! PAL 504 , NTSC 5i 2 
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2268 

UMX0 

•LDfl 3LSB,V 

;ADD OFFSET TO SPRITE X 

2270 


ADC OSL 

;C SMSB+X,SLSB+V J =... 

2230 


STR SLSB,Y 

; ... C SMSB+X,SLSB+V 3 + C OSH,OSL 3 

2290 


LDfl SMSB,X 


2300 


RDC OSH 


2310 


STR SMSB,X 


2320 


SEC 

;IS THE SUM >= MODULUS? 

2330 


LDR SLSB,Y 

;CHECK BV SUBTRACTING 

2340 


SBC MODL 


2350 


STR Tfl 

;CATCH FOR LATER USE 

2360 


LDfl SMSB,X 


2370 


SBC MODH 


2330 


BCC UMX1 

;IF SUM < MOD THEN EXIT 

2390 


STR SMSB,X 

;OTHERWISE CORRECT .X-COORD 

2400 


LDR Tfl 


2410 


STR SLSB,V 


2420 

UMX1 

TVR 

;RESTORE R REG 

2430 


LSR R 


?<■ 46 


LDX TX 

;RESTORE X REG 

2450 


RTS 


2460 

s 



2470 

/ 

TRANSFER 

SPRITE MSB BYTES TO MSIGX BITS 

2430 

• 

r 



2490 

RTVMX 

LDX #7 


2500 

fiTV0 

LDR SMSB,X 


2510 


LSR R 


2520 


ROL MSIGX 


2530 


DEX 


2540 


BPL RTV0 


2550 


RTS 


2560 

/ 



2570 

■ 

r 

TRANSFER 

SPRITE MSIGX BITS TO MSB BYTES 

2580 

m 

S 



2590 

VTflMX 

LDX #7 


2600 


LDfl MSIGX 

- • 

2610 

VTA0 

LSR SMSB,X 


2620 


ASL R 


2630 


ROL SMSB,X 


2640 


DEX 


2650 


BF'L VTR0 


2660 


RTS 


2670 

■ 

r 



2630 

m 

O 
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Ea 
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requires the user 

to 

i n i 

t i 

the y 

re -3 i 

=!± 

er 

• to 

th< 

e tote. 

1 number. 1 

of bytes to operate 

O 

n ro i 

nu- 

The 

AND I fr£» 

•.-it. i n 
“two 

b 

X 

lo 

r.c 1 
cks 

ude 

of 

: tran 
rnernor: 

sf err in *3 
y to*:iethei 

a. b lock of memory, 
r end storing the r 

lo 

eS' 

•3 i ce. 
u It 

,1 lj 
i n 

Tf i i rd 

b loc 

kjp 

1 

0*3 I 

cel 

ly ORi 

n*i two b 1 

o c k s o f m e rri o r y >r .=, r,, : { 

1 

C»'3 i c 

el 

EGR i n*:< 

± 1 . 1.1 Cl 

b 

lO' 

cks 

of 

memor; 

y. R sec- 
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i 

0'3 i c 
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c< 
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Expositions 

b f‘ i''C' , i<f‘'-3/ri u si; i n*i .asssffib ls , d -a* *U1O0, 

1> Assembly 


' 1 4 > 


1 COO 

. PAGE 

: cutoi 

1 010 

t 


1 020 

*=*61 


1 0 S 0 

SRC 1 

*=*+2 

1 040 

SRC 2 

*=*+2 

1 030 

03 T 

*=*+2 

1 060 

MASK 

*=*+1 

1070 

*=*C 1 

00 

1 080 

; 


1 090 

; THES 

E ROir 

1 1 00 

;OPERATION? 

1110 

: AND 

TWO S| 

1 120 

EGR 

TWO Sf 

1 130 

; OR A 

3 PR I' 

1140 

; WI TH 

A MR:! 

1150 

: AND 

TRANS! 

1160 

;CHARACTER 


fS/CHRR:=;, 


50 ;FIND transfer r sprite, ’CHAP pattern 
60 CHARACTER EHTRV pnIMTR BEGIN WITH A C, SPRI 

. CHTPV PflTllT... ' " r-.r-.-TL, I t T “T"! I ail •”* . 


1 170 

Jise :HO NUMBER SUFFIX." 
0/15/52 


te 


Corn modore 
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1190 
1200 
1210 

1240 
1250 
1260 
1270 


. AUTHOR JOE MCENERNEV BILL HINDORFF 

: * M f: H** +: :f • fi : * f: f: :■* f f ££ if: if::+: if f: £ if: f f f' f: f f: f::+: f £ £ £ f £: if: 
;:+• SET THE SRCl.-X POINTER TO BE THE ACC 
;f TIMES 64. X SHOULD BE 0 FOR SRC1. 

;f: 2 FOR SRC2HMD 4 FOR DST. 

SR PA 


1 £80 

LDV 4$00 



1290 

STV SRC1..X 



1 300 

LSR A 

;MULTIPLV ACC BV 

64 

1310 

ROR SRCI.pX 

;AND CREATE LOW . 

HI 

1320 

LSR A 

POINTER 


1330 

ROR SRC1 r X 



1340 

STA SRC1+1,X 




1350 
1360 
1370 
1330 
1330i 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1430 
1430 
150O 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1530 
1530 
16Ot0 
1610 
1620 
1630 
1640 
1650 
1660 
1670- 
1630 
1630 
1 700 
1710 
1 720 


RTS 


SET THE SRCl.-X POINTER TO BE THE ACC 
TIMES EIGHT. X IS 0 FOR SRC 1.. 2 FOR 
SRC2AND 4 FOR DST. 


CHF'A 


LDV 40 

STV SRC1 + 1..X 
ASL A 

ROL SRC1 + 1.-X 
ASL A 

ROL SRC 1 +1.. X 
ASL A 

..ROL SRC1 + 1..X 
•* STA SRC1..X 
RTS 


;f: DUPLICATE SRC2 POINTER AS THE 
f: DESTINATION POINTER DST. 


S2DST 


LDA SRC2 
STA DST 
LDA SRC2 
STA DST+1 
RTS 


:* FI|_L THE PATTERN POINTED TO B'r 
:* DST WITH THE VALUE IN THE ACC 
if ACC IS TVPICALL't 1 00 OR FF. 


f £' f::+: if:^ 




3ETCH 


2 / 15/82 


Commodor i 


>:•■=*.•!< *=• *=• 


L 



1748 LDV 

#7 

..sENTRV FOR 

CHAR. SET 

1758 BNE 

SETSP1 

jALWAVS 


1760 SETSP 


;ENTRV FOR 

SPRITE SET 

17 -, 8 LDV 

1738 SETSP1 

#62 

:ENTRV FOR 

PRE-OEFINED 

179® STA 

1388 DEV 

< DST >., V 

.;# OF BVTE: 

S TO FILL 

1818 BPL 

1828 RTS 

SETSP1 




1 S3® 
134 ® 
1850 
1868 
187 ® 
188 ® 
189 ® 
190 ® 
1910 
1928 
1938 
1 94 ® 


.:* TRANSFER THE PATTERN POINTED TO BV SRC1 
;* TO THE LOCATION STARTING AT DST 

CXFER 

LDV #7 
BNE SXFER1 

SttFER 

LDV #32 
SXFER1 


1950 

LDA 

< SRC: 1 > 

.. V 

1360 

STA 

<DST>.. 

V 

1370 

DEV 



1380 

BPL 

SXFER1 


1330 

ROL 

A 

. 

2000 

RTS 



20 1 0 




2020 

; $$$$$$$• 

******* 

*************************** 

2030 

;* LOGICAL AND 

THE PATTERN POINTED TO BV 

2848 

SRC 1 1 

WITH A 

MASK 

2850 

; *******; 

******* 

*************************** 

2860 




2070 

CANDM 



201001 

LDV 

#7 


20i30 

BNE 

SANDM1 


21 0101 

SANDM 



21 10 

LDV 

#62 


2120 

SANDM1 



2130 

LDA 

<SRC1> 

,.V 

2140 

AND 

MASK 


2130 

STA 

CDST>.. 

V 

21 £0i 

DEV 



2170 

BPL 

SANDM1 


2130 

RTS 



2130 

; 



22®@ 

; mmmm 

******* 

*************************** 


-•-•18 :* LOGICAL OR THE PATTERN POINTED TO BV 
"“•20 ;* SRC 1 WITH A MASK 


LDV #7 
BNE SOPM1 


;40i 

• 

50i 

CORK 

:60 


70 

00 

SORM 


o/l5/®2 


Commodore 


A. 



2230 

LDV #62 

• 

2300 

SORM1 


2310 

LOR CSRCl 


2320 

OPR MASK 


2 2* 3 *L* 

STR COST/ 

i i 

T 

2340 

DEV 


2350 
2 3 >50 

BPL SORM1 
RTS 


2370 

2330 

• 4 :-*i 4:4 44 4 4 4 4 444 

44444444444444444444444 

2:330 

:4 LOGICAL EOR 

THE PATTERN POINTED TO 

2400 

4 SRC 1 WITH A 

MASK 


2410 
2420 
2430 
2440 
2450 
2460 
2470 
2430 
2430 
2500 
2510 
2520 
2530 
2540 
2558 
2560 
2570 
2530 
2530 
2600 
2610 
2620 
2630 
2640 
2650 
2660 
2670 


44444444444444444444444444444444444444444 

CEORM 

LDV #7 
BHE SEORM1 

SEORM 

LDV #62 
SEORM1 

LOR <SRC1>,V 
EOR MASK 
STR < D3T > V 
DEV 

BPL SEORM1 
RTS 

•44444444444444444444444444444444444444444 
;4 LOGICAL RHD THE PATTERN POINTED TO BV 
•4 SRC1 WITH THE PATTERN POINTED TO BV 
•4 SRC2 AND STORE IT IN DESTINATION DST 

.44444444444444444444444444444444444444444 


candc 


SANDS 


LDV #7 
BNE SANS0 

LDV #62 


-:70 SRNS0 


>680 

CLC 


:S90 

SANS 1 


>700 

:710 

i'720 

LDA 

AND 

STR 

< SRC 

< SRC: 

< DST 

•730 

BEQ 

sans; 

;740 

SEC 


750 

SANS2 


:730 

DEV 


770 

BPL 

SANS 

:7S0 

RTS 


730 

• 



2S1 * : * L0G1 CGl : ° P ruT PATTERN 'POINTED To" BV 

2320 >* WI J H ,I*pp IT IN DESTINATION DS1 

;4 SRC2 AND bTUht 


Oofftfitoclor'-'S 


3/1 





/ 


2540 j^^-ti^vK*^^*^^^****^*^*^^**^***^^ 
2550 ; 


2550 COPC 


2570 LDV 

47 

2550 BNE 

SORS 1 

2550 SORS 


2500 LDV 

#62 

2510 SORS1 


2520 LDA 

< SRC 1 

2550 ORA 

•:;SRC2 

2540 :=:T A 

COST':- 

2550 DEV 


2560 BPL 

SORS 1 

2570 RTS 



2550 .; 

2550 

5000 ;* LOGICAL EOR THE PATTERN POINTED TO BV 
5010 .:* SRC1 WITH THE PATTERN POINTED TO BV 
5020 .:* SRC2 AND STORE IT IN DESTINATION DST 
5050 
5040 ; 


5050 CEORC 
5060 LDV 

#7 


3670 

BNE 

SEORS 

1 

5050 SEORS 
5050 LDV 

#62 


5100 SEORS1 
'3110 LDA 

£ SRC 1 

> , V 

5120 

EOR 

0SRC2 

V 

5150 

STA 

•:; DST > 

, V 

5140 

5150 

DEV 

BPL 

SEORS 

1 

5160 RTS 

5170 : 

51 SO ; 

5150 .END 




Hex dump: 


2166 

30 

00 

34 

61 

43 

76 

61 

2110 

62 

OR 

36 

62 

03 

36 

62 

2126 

65 

35 

6 3 

•i'5 

66 

60 

36 

2136 

FB 

60 

30 

07 

00 

02 

30 

2146 

60 

36 

07 

DO 

62 

36 

3E 

2156 

60 

36 

07 

DO 

02 

30 

OCT 

l— 

2160 

60 

36 

07 

DO 

02 

36 

3E 

21 70 

60 

36 

07 

DO 

02 

30 

3E 

2180 

•“■O 

S3 

10 

F4 

60 

36 

67 

2130 

65 

C'O 

10 

c"y 

60 

30 

07 


4A 

OA 

76 

36 

61 

62 

35 

35 

62 

61 

60i 

60i 

30 

35 

0101 
cT 'j 

54 

* C'C 

07 

5E 

B1 

DO 

61 

61 

02 

61 

25 

30 

31 
67 

3E 

65 

31 

31 

65 

65 

10 

F9 

10 

2A 

61 

61 

05 

67 

31 

cTcr 

-• 

10 

F7 

B1 

61 

45 

67 

31 

kL'C 


10 

F7 

15 

DO 

DO 

B1 

02 

02 

61 

30 

30 

31 

OCT 

5E 

63 

Bl 

Bl 

r Z> -_i 

Q i 
*. 

61 

61 

65 

11 

51 

10 
F0i 
6 3 
63 

F7 

01 

51 

51 



'— c< rn rii o «:<o r-- •=■ 


P 5.*ie 5 





3' Ort s. statements : 


DATA 168, 8 , 148, 97, 7 ^ , 118, 37 ,74,11 8 , 37 .<43 
DATA 98, 96, 1600, 14 8,98, 10 ,54 , 98, 1 0 54 , 33 
DATA 10, 54, 98 .,1499796165991331 © 1 . 155 
DATA 99133102961 68 7208 .,2,168,62,145 
DATA 101,136 , 16., 251., 96., 168,7., 288,2, 168,62 
DATA 177., 97, 145., 181,136,16,249,42., 96,16*3,7 
DATA 288 , 2 , 168 , 62 , 1 77,97,37, 1 83, 1 45, 181 ~ l 3 $ 
DATA 16,247,96, 168,7,208,2., 168,62, 177,97 ,3 
DATA 183, 145,181,1.36., 16., 247., 96., 168,7,288,2 
DATA 168,62 , 177,97,69, 183 ,145,181 , 136 , 16., 247 
DATA 96 , 168,7,288,2., 168,62,24,177,97,49 , S3 
DATA 145,181,248,1,56,136,16,244,96,168 * 7 ' 
DAT A 288,2,1 68 ,62,177,97,17,99,145,181 * 136 
DAT A 16,247,96,168,7,288,2,168,62,177,97,81 
DATA 99,145,73 


b 

> Memory 

bytes 

ot memor 

O.C C U 1 T 1 U 

let or err 

- 

Worst 

on a. 1 1 

.02 MHz 

d 

> F'r i or 

be initialized 

■j. u b r 0 u t i n e * r s c 

& 

m 

1 

pointer 

-s, ORs 

memory 

start i n- 

1 000 ( 

URTWO 

1 0 1 0 

LDA 

1 020 

LDX 

1 030 

JSR 

1 040 

LDA 

1 050 

LDX 

1 060 

JSR 

1070 

LDA 

1 0 80 

LDK 

1 090 

JSR 

1 1 00 

JSR 

1200 

ore- 


must 


e> Example: The -following program initializes the three -p-rit*=- 
pointers, ORs two sprite patterns together, end places the r*--w It in 


“87FA 


SORS 


;SET SOURCE 1 ADDRESS 

;SET SOURCE 2 ADDRESS 

■ SET DESTINATION ADDRESS 

:UR THE TWU PATTERNS AND STORE 


Commodore 


Page 4 







:=: O F" T LJ 1=1 Ft EE F! F‘ F' L_ I ChT X ON 

m ci t e: i ci ci a 



[ 

X* • 



H i_j ~*7. I—i r“ 


H i r.dor 


:=’• i_j fcr« _i = Sprite pattern mirroring arid shifting. 

T" *=• l*s- ± ± >-< r~i :=: -fc c4 -=*j— cd = NT SC sr PflL 


Fs Jo is? “t t-~- -fc = These routines take a. user defined sprite m PfiM 

ard ret leer it atoout its central :■•—axis, reflect it about its 
central x-axis, shift/rotate left, and shif t.-'rotate up. Prior to 
heinii called., a pointer to the star-tin* address of the sprite data 
<sprv must he initialized. In the case of shifting or rotating., the 
i register must also he set with the number of hits to shift. 




SROL 


1 










1 
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r 























i 



i 
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1 1 


1 



1 
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M 

i i 

H 

u 

u 

I 1 

u 

1 
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J 

i 

hr 













a 

u 

1 


i 


1 


1 . 















1 

d 

1 

a 

□ 

r 

r— 


J 


1 








-J 




p 

i 

i 

1 

H 

H 

H 

i 




n 

i 


1 







| 






i 

i 

u 

1 







j 

-j 

i 

—r 

1 

-l — 

f 


i 



















i 

j 

j- 

• 

n 


Tl 

_ 

J 

I 

J 




i 







>;- p.^r. -— - 


«ii ^^ 
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Program 1 i s*i n*i zs asssmto led sc* $C i 00. 


fissercb ly : 


1000 
1016 
1 @20 
1 030 
1 040 
1 050 
1 060 
1070 
1 0 0 0 
1 030 
1 1 00 
1110 
1120 
1130 
1140 
1150 
1 1 £0 
1170 
1180 
1190 
1200 
1210 
1 220 
1230 
1240 
1250 
1260 
1270 
1230 
1290 
1300 


.PAGE CSPYTRN9/19 > 

#=$61 
SPR $=#+2 
3PRH #=#+2 
BUFFER *=*+1 
#=$C100 

*THIS ROUTINE WILL FLIP THE SPRITE AT'ADDRESS SPR 
;ABOUT THE V-FIXIS <RUNNING THRU THE CENTER 
;BETWEEN BITS 11 AND 12>. SPRH IS EQUAL TO SPR+2. 
; PR I OR TO CALLING THE ROUTINE., THE USER SHOULD 
;INITIALIZE SPR AND"SPR+1 TO THE SPRITE'S 
;STARTING ADDRESS IN MEMORY. 

THE SPRITE SHOULD .BE IN HIRES MODE. 


: AUTHOR BILL HINDORFF 
VFLIP 

LDV #$3C 
VFLIPP 

LDA SPR 
CLC 

ADC 42 
STA SPRH 
LDX SPR+1 
BCC VFLIP0 
I NX 

VFLIP0 

STX SPRH+1 
VFLIP1 


.: INITIALIZE V 

;GET LOW BYTE OF SPRITE POINTER 

:CREATE SPRH LOW BYTE 
: AND SAVE IT 

:GET HI BYTE OF SPRITE POINTER 
.;SHOULD IT BE INCREMENTED 


; YES -• 

..•SAVE SPRH HIGH BYTE 


4/32 


Commodor-a 











































































































































7 


1310 

LDP •: 3PR > .r V 

.•GET THE LEFT BYTE 

1320 

3 T R BUFFER 

SAVE IT AWAY 

1330 

LDP < SF'RH' ,V 

jGET THE RIGHT BYTE 

1340 

LDX #7 


1358 

VFLIP2 


1 O 

PCL P 

:FLIP LEFT BYTE 

1370 

RCR BUFFER 

..•AND RIGHT BYTE 

1330 

ncy 

U_ 1 1 


1330 

BPL VFLIF‘2 


: 400 

POL P 


1410 

S7R <3PRK>,V 

;PUT FLIPPED RIGHT BYT! 

1420 

LDP BUFFER 


1430 

STP SPR > V 

..-PUT FLIPPED LEFT BYTE 

1440 

DEV 


1450 

LDP <3PRH> .r V 

;GET CENTER BYTE 

1460 

STP BUFFER 


1470 

LDX #7 


1430 

VFLIP3 


1430 

ROL P 


1500 

POP BUFFER 

.FLIP CENTER BYTE 

1510 

de:*- 


1520 

BPL VFLIPS 

* 

1530 

ROL P 


15-0 

3TR < SPRH > V 

PUT BACK IN CENTER 

1550 

DEV 


1560 

DEV 

;POINT TO NEXT ROW 

1570 

BPL VFLIPI 

;BRANCH IF NOT DONE 

1530 

RTS 


1590 

; 



1 600 
1610 
1620 
1630 
1640 
1650 
1660 
167© 

1630 
1690 

1700 LDV #62 

1710 SRQL0 


* THIS SUBROUTINE WILL TAKE fi SPRITE PRTT^PN 
3ft WHICH IS LESS THAN 24 BITS WIDE AND ROTATE 

* IT TO THE LEFT. THE X REGISTER SHOULD BE 
ift PRE-SET WITH THE NUMBER OF BITS TO ROTATE 

3ft AND SPR SHOULD CONTAIN THE LOW/HI POINTER TO 

* THE STARTING MEMORY LOCATION OF THE SPRl^ " 


***** 


ROL 


1720 

STX 

BUFFER+2 

:ENTRY IF SPRITE IS N 

1730 

SR0L1 


; HIGH 

1740 

LDA 

<SPR>,Y 

•get the right byte 

1750 

TAX 


SAVE IT 

1760 

DEV 



1770 

LDA 

< SPR > .. Y 

•GET THE MIDDLE BYTE 

1730 

STA 

BUFFER*1 

SAVE IT 

1 730 

DEV 



1300 

LDA 

<;SPR> , Y 

•GET THE LEFT BYTE 

1310 

STA 

BUFFER 

; AND SAVE 

1320 

TXA 


:START WITH THE RIGHT 

1330 

LDX 

buffer 

;GET NUMBER OF BITS r. 

1340 

SR0L2 



1350. 

ASL 

R 

;SHIFT RIGHT BYTE 

1360 

POL 

BUPFER+1 

;ROTATE MIDDLE BYTE 

1370 

ROL 

buffer 

ROTATE LEFT BYTE 


'- 1 SHIFT 


9/24/32 


Commodore 


A*** 4 







1330 

ADC £$00 

SE f 

LOW OF ROC 


i c- o ci 

ncy 



• 

—1300. 

BNE SR0L2 




1310 

I MV 




1320 

IHV 



1330 

STR < SPR> V 

:STO 

RE RIGHT 


1340 

DEV 




1330 

LDft BUFFER*1 




1360 

C; Jp ,'5pC;) „v 

AND 

MIDDLE 


1370 

DEV 



• 

1330 

lcr BUFFER 




1330 

STR •' SF'P > .. V 

;RND 

LEFT 


2010101 

DEV 




20i 10 

BPL SROL! 




20120 

RTS 






203G 
2040 
2050 
2060 
2070 
2030 
2630 
2100 
2110 FLIP* 


$ THIS ROUTINE FLIPS ft SPRITE ABOUT ITS X 

* AXIS. THE USER PROVIDES THE STARTING 

.4: POINT OF THE SPRITE TO FLIP IN ft POINTER 

* CALLED SPfi 

if :'f f f if! if f if if if if .4.' if: if if if if if if if if if if if f f f f f f f f if f if if if f f f f if 


C 


2120 

■ ric/ 

SF'R+1 


2130 

STR 

BUFFER+1 


2140 

STR 

SPRH+1 


2150 

LDR 

SPR 


21601 

OLD 



2170 

RDC 

#•£ 1B 

;CREATE R POINTER TO 

2130 

STR 

BUFFER 

CENTER OF SPRITE 

2130 

BOO 

FLIPV1 


2200 

INC 

BUFFER+1 


2210 

FLIPVI 



2220 

OLD 



2230 

RDC 

me 

AND--A POINTER TO JU 

2240 

STR 

SPRH 


2250 

BCD 

FLIPV2 


2260 

I NO 

SPRH+1 


2270 

FLIPV2 



2230 

LDV 

m? 

;COUNTER FOR HALF R 

22301 

STV 

BUFFER+2 


2300 

FLIPVS 



2310 

LDV 

m-2 


2320 

FLIPV4 



23301 

LDR 

BUFFER >,V 

?GET BYTE OF UPPER SI 

2340 

TftV 


: SAVE IT 

2350 

LDR 

o:sprh> ,V 

GET BYTE OF LOWER SI 

2360 

STR 

<BUFFER>,V 

PUT IT UP TOP 

2370 

TVR 



23S0 

STR 

< SF'PH > V 

PUT UPPER ORTR DOWN 

23301 

DEV 


;DO NEXT IN R LINE 

24010 

BPL 

FLIPV4 


2410 

LDR 

BUFFER 

-• 

2420 

SEC 



2430 

SBC 

mm 

MOVE BACK R LINE 

2440 

STR 

SUFFER 



JUST ABOVE 


i/ 24/S*^ 


Commodore 


p-a*ie 








2450 

c* re- 

i-' •_ • •_■ 

FLIPZ5 

24601 

DEC 

BUFFER+1 

2470 

FLIP/5 


2 ^x 0 

LDA 

SPRH 

24 50 

CLC 


2500 

*oc 

4T08 

2510 

ST A 

SPPH 

2520 

BCC 

FLIP /6 

2530 

INC 

SPRH+I 

2540 

FLI P /6 


2550 

DEC 

BUFFER+2 

2560 

BPL 

FL I P/3 


. m fy./cr p-.-.pi.jCjpn p 1 7 ucr 


RTS 


2570 
25S0 
25501 
2606 
2618 
26201 
2630 
2 6 *4 0 

2660 - 


******************************************* 

:* THIS ROUTINE SHIFTS ft SPRITE PATTERN UP 
:* AFTER IT HAS BEEN FLIPPED ABOUT X 
;* THE USER NEEDS TO SET THE STARTING POINTER 
:# OF THE SPRITE IN ACC AND THE NUMBER OF 
;:+: LINES TO SHIFT TIMES 3 IN THE X REGISTER 


2630 

LDV 

#TOC 


26301 

LDA 

SPR+i 


27010 

STA 

SPRH+1 


2710 

T/ft 



2720 

CLC 



2730 

ADC 

SPR 

:CREATE A NEW POINTER 

2740 

STA 

SPRH 

,:THE STARTING LINE TO 

2750 

BCC 

SFTUP1 

SHIFTED UP 

2768 

INC 

SPRH +1 


27701 

SFTUP1 



2730 

LDA 

< SPRH > V 

;GET A BVTE TO SHIFT 

2730 

STA 

< SPR > .. V 

;PUT IT CLOSER TO TOP 

230101 

I NY 



2310 

I NX 



23201 

CPX 

#63 


23301 

BNE 

SFTUF'l 


2340 

LDA 

#*©e 

;ZERO THE BOTTOM LINE 

2350 

STA 

<■. SPR > .. V 


23601 

DEV 



23701 

STA 

<: spr > , v 


2330 

DEV 



23301 

STA 

SPR > .. V 


230i0i 

RTS 




-A 10 
2920 
2930 
2940 
2950 
29S0 
2970 
2980. 
2990 
2000 
2010 


THIS SUBROUTINE WILL TAKE A SPRITE 
WHICH IS LESS THAN L4 EITs WIDE 
IT TO THE LEFT. THE _ : 2_ R ?5 ISTE J SHOULD*BE 


pattern 

and shift 

WITH THE NUMBER OF BITS TO SHTPr 

SHOULD CONTAIN THE LOW. 'HI PiTTWTrc r- 
--- fcr? fij 


***** 


PRE-SET 

AND SPP -- 

THE STARTING MEMORY LOCATION OF 

********* 


THE SPRUE 


asl 


•?. '24/82 


•ommodore 


>:• r 4 -'^ •=* 













f 


3020 

3@30 

3040 

3250 

8060 

'307i? 

3030 
3030 
3100 
3110 
3120 
3130 
3140 
3150 
3160 
3170 
3180 
3130 
3200 
3210 
3220 

3240 
3250 
3260 
3270 
32301 
3230 
33001 
3310 
3320 
33301 
3340 
3350 
3360i 
3370 
338© 
3390 
3-010 
3410 
3428 
34301 


LC"-' #62 


Sn'3L8 


STX BUFFER+2 


LDfl 

Tftv 


IDO 


LDA <SPR>,V 
STA BUFFER+1 
DEV 

LDA «rSPR>..V 
STA BUFFER 
TXA 

LDX BUFFER+2 


SASL2 


ENTRV IF SPRITE IS NOT 21. BITS 

. U J fiU 

:GET THE RIGHT BVTE 


GEf THE MIDDLE BVTE 
.5SAVE IT 

SET THE LEFT BVTE 
• ooyc 

;START WITH THE RIGHT 
;GET NUMBER OF BITS TO SHIFT 

..•SHIFT RIGHT BVTE 
ROTATE MIDDLE BVTE 
; ROTATE LEFT BVTE 


ASL A 

RDL BUFFER+1 
ROL BUFFER 
DEM 

BHE SASL2 

INV 

IHV 

STA < SPR> ,V 
DEV 

LDA BUFFER+1 
STA <SPR>, V 
DEV 

LDA BUFFER 
STA <■. SPR > .. V 
DEV 

BPL SflSLi 
RTS 


•=f: THIS ROUTINE ROTATES A SPRITE PATTERN UP 
.+:• AFTER-IT HAS BEEN FLIPPED ABOUT X 

* THE USER NEEDS TO SET THE STARTING POINTER 
M OF THE SPRITE AND THE NUMBER OF LINES 

* TO ROTATE IN THE X REGISTER. 


SROUP 


:STORE RIGHT 


:AND MIDDLE 


sAND LEFT 


3440 

LDA 

SPR+1 

3450 

STA 

SPRH+1 

3460 

LDA 

SPR 

3470 

CLC 


3480 

ADC 

#-T03 

3490 

STA 

SPRH 

3500 

BCG 

SROUP1 

3510 

INC 

SPRH+1 

3520 

SROUP1 


3530 

LDV 

#—•0101 

3540 

LDA 

< SPR > .. V 

-;550 

STA 

BUFFER 

3560 

INV 


3570 

i no 

^.cri 

SPR > .V 

3530 

STfl 

BUFFEP+ 


; SAVE_THE TOR SPRITE LI ME 


A.-24'3- 


CornfrtCicior»=. 







3 .90 

IHV 


5600. 

1 £.C| 

::spe:\.v 

361 0 

STR 

BUFFER+: 

3628 

LBV 

#200 

3630 

SR0UP2 


3640 

L r 'fl 

SPRH > .' 

3650 

STR 

<spr:: ,v 

3660 

I HV 


3670 

• CPV 

#rsc 

3638 

SHE 

SR0UP2 

3690 

LDfl 

BUFFER 

37010 

STfl 

<:spr>,v 

3710 

I HV 


3728 

LDfl 

BUFFER+ 

3738 

STfl 

<SPR>,V 

3740 

I HV 


3758 

LDfl 

BUFFER+i 

3768 

STfl 

<SPR>,V 

3778 

OEX 


3730 

SHE 

SROUP1 

3798 

RTS 


3388 

. END 



»'GET 


next sprite line 

IT r " !RRE?*-! T L 


[|QT C 
ijtr 

• >u_ 


2 PUT THE TOP LINE ON BOTTOM 


2> Hex Dump?, 


• 

21 00 

R8 

sc 

AS 

61 

is 

69 

02 

i”.cr 

63 

R6 

62 

90i 

01 

• 

2110 

B1 

61 

Cj cr 

65 

Bi 

63 

R2 

87 

2fi 

66 

65 

OR 

10 

■ 

2120 

63 

fl5 

65 

91 

61 

oo 

Bl 

jCp 

35 

65 

R2 

87 

2R 

, 

2138 

10 

Ffi 

2R 

91 

63 

Op 

oo 

10 

07 

60i 

R0i 

3E 

36 


2148 

RR 

•50 

B1 

61 

C*c* 

66 

oo 

Bl 

61 

OCT. 

65 

SR 

R6 

e 

2158 

66 

26 

65 

69 

00 

OR 

00 

F6 

03 


91 

61 

3 3 

■ 

2168 

61 

33 

R5 

65 

91 

cT 1 

X 

c«o 

10 

05 

60i 

R5 

62 

85 

• 

2170 

R5 

61 

IS 

69 

IB 

35 

65 

90i 

02 

E6 

66 

IS 

69 

• 

2138 

90 

02 

E6 

64 

R2 

09 

36 

67 

R0i 

02 

Bl 

65 

RR 

• 

2198 

65 

3R 

91 

63* 

oo 

10 

F3 

R5 

65 

33 

E9 

03 

85 

. 

21R0 

C6 

66 

R5 

63 

13 

69 

0i 3 

.“.cr 

S3 

98 

02 

E6 

•64 

. 

21B0 

07 

6Gi 

ft© 

00 

R5 

62 

•;*cr 

64 

SR 

1 

x 

65 

61 


. 

21C0 

E6 

64 

B'l 

63 

91 

61 

03 

ETC* 

i— 

E0 

3F 

08 

F6 

R9 

, 

2100 

83 

91 

61 

c* o 

91 

61 

SO¬ 

R0i 

Ou 

36 

67 

Bl 

61 

. 

21E8 

61 

per 

66 

o o 

Bl 

61 

BS 

65 

3R 

R6 

67 

0i R 

26 

, 

21F8 

OR 

08 

CO 

C8 

03 

91 

61 

c* *5 

R5 

66 

Ci « 

61 


• 

22010 

61 

88 

10 

07 

66i 

R5 

62 

35 

64 

R5 

61 

IS 

6 9 

. 

2218 

90t 

02 

E6 

64 

R8 

00 

Bl 

61 

35 

65 


Bl 

61 

• 

2228 

B1 

61 

35 

67 

R8 

00 

Bl 

63 

91 

61 

pO 

00 

* 

2238 

2248 

65 

68 

■Zi 1 

•• i 

00 

61 

00 

C3 

00 

R5 

00 

66 

00 

91 

0101 

61 

00 

cs 

00 

R5 

010 

67 

0101 

91 

010 

■2‘ 

61 

00 


ES 86 
FR 2 fi 
66 65 
67 B1 
67 8R 
R5 66 
66 S'5 
06 RP 
B 1 63 
63 BO 

63 30 

0© g i 

FR 88 
66 26! 
fl5 S3 
03 05 
S3 66 
D© F 7 
Cfl 00 
00 00 


64 

31 

Cfl 

61 

26 

31 

64 

63 

31 

02 

10 

02 

61 

B1 

63 

31 


fl3 

04 

00 


*.■■•24/82 


Commodore 










Data Statements: 


DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 

DRTR 


168, 68 , 165, ?7.24 .. 185 ,2, 1333?, 166, 33.. 1 '-*- 4,1 ,232 ,1 34 
188,177,3?, i33, 181, 177,33, 162, 7.. 42.. 182,181 282, 16 
258,42,14 5,33 , : 65 ,181,145,37, 136 , 1 7'.. 33 , j , 181 , 162 
7,42,182,181,282,16,258,42,145,33,136.136.16.215,34 
168,62,134,183,177,37,178,136,177,37,133,182‘136’177 
37,133,181,133,166,183,18,33,182,33,181,185.8.282 

283.246.288.288.145.37.136.165.182.145.37.136.165 

181.145.37.136.16.213.36.165.33.133.182.133.188.165 
37,24,185,27,133,181,144,2,238,182,24,185,6,133,3?• 

14 - 4 , 2,238 , 188 , 162 , 3,134 , 183 , 168 , 2 , 177 , 181 , 178 , 177,33 
145 , 181 , 133 , 145 , 33 , 136 , 16 , 243 , 165 , 181 , 56 , 233 .^ 3 , 133 * 

101.176.2.133.182.165.33.24.185.3.133.33.144.2.238 

188 , 133 , 183 , 16 , 215 , 36 , 168 , 8 , 165 , 33 , 133 , 188 . 133 , 24,181 
37 , 133 , 33 , 144 , 2 , 238 , 188 , 177 , 33 , 145 , 37 , 288 . 232 , 224,63 
283 , 246 , 163 , 8 , 145 , 37 , 136 , 145 , 37 , 136 , 145 , 37 , 36 , 168,62 
134 , 183 , 177 , 37 , 178 , 136 , 177 , 37 , 133 , 182 , 136 , 177 , 37,133 
181 , 133 , 166 , 183 , 18 , 33 , 182 , 33,181 , 202 , 283 . 243 , 288,288 
145 , 37 , 136 , 165 , 182 , 145 , 37 , 136 , 165 , 181 , 145 , 37 , 136 . 16 

215 . 36 . 165 . 33 . 133 . 188 . 165 . 37 . 24 . 185 . 3 . 133 . 33 . 144 . 2.238 
1 ‘ r 1 . 1 •' 1 f ® •'* ■' 177 •' 37 •’ 1 33 , 181 , 288 , 177 , 37,133 , 182,288 , 177,37 
133 , 183 , 168 , 0 , 177 , 3 ?, 145 , 37 , 288 , 132 , 68 , 283 , 247 , 163,181 

145.37.288.165 , 182 , 145,37,288 , 165.183.145,37,282', 208 " 

212,36 ■' 


c > Memory/Reg i ster 
.<$141> bytes of memory, 
and 7 bytes of storage. 


r eguirements : This routine requires 321 
It uses the -accumu let or, X, and V registers 


d> Worst case execution time is 1082*2+23 cycles tor the 3RD! IP 
routine. Where Z is egua.l to the number of times the sprite i- 
rote.ted up. 


■s' Limitations; To mirror -a multi-color sprite -about the 
y—ex is, the yt lip routine is called then multi-color location *37 
<$25> -and the sprite color location 33 to 46 c;s27 to S2e> * 
interchanged. Note that this will only work tor one sprite un !*•=■=• 
.all sprites have the same coloring. Also, the sprite p.at+l rn ’ *[11 
be in RRM. " • 


t > Rrior 
, ; ,t the sprite 
Rpnote 41082''. 
h - conditioned 


to using these subroutines a pointer to 
■'called spr> must be set-up <•• 


<*** tn* 

The shitt routines also require that th* . 'T ,_ ‘ + 

with the number ot bits to shift. ' f agister 



Commodore 




3 






*.'• £ s/iip le: This e:=-:z;w- le copies -s. sprite h-etterr. to RRK 
t lirs it shout the ?::••:is. fitter the r.s.ttern is - ’ : r-ped it 
shi i ft*s:* un t-o i ts or i i< i ns. 1 loc s.t i or w: th i r the srr i t* m s.tr i x. 


ther 

is 



Cl_ T p . 


LDP #$C0 
ST.fi S07F3 
LDV #$00 
JSF: SPPR 
LDV #$3F 

FLIF1 


LOR SPORTR,V 
STfi ’.'f£ 1 > .v 
DEV 


BPL FLIP1 
LDR #$90 
STfi $0000 
SIR fODDI 
LDR #$01 
STfi $0013 

FLIPS 

JSP FLIPX 
LDH #S0D 
JSP SROUP 
LBK #$00 
LDV #$00 

FLIP:? 

DEV 


SHE FLIP? 
DEV 

SHE FLIP? 
•JMP FLIPS 


r 


3/24, 


O 


Commodor® 
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AFT NOIL LOCK 


COLLISION DLTLCTION 


o i r r inj a r < tz a i~ m i_ l iZ .a no m 

KO'IL i(JD4 



Andy i**inkel and Joe flcLnerneu 
Oprite Collision Detection 
NTSC or PAL 


ACC7 FvACT 


The detection oT collisions is often 
computer and video dames. The 6566/656/ s 
of collisions; sprite to sprite collisions 
collisions. In deneralr 3 collision is de 
non- transparent sprite data coincides with 
data on another sprite or non—transparent 


an important part of 
astern supports two types 
and sprite to screen data 
fined as the instance when 
either non transparent 
data on the screen. 


A. SF’FxllL 70 CPFClTE. COLLISIONS 


ABSTilAC r 


This routine will interpret the sprite collision and sprite 
position data provided by the VIC II 6566/656/ chip to d*t 
which sprites are actually i r. collision. 1 he collision d*t*cti 0 
i„ ^ d i s t e r on the 6566/656/ chip is used to determine which <- p ., 

COULD be involved in a collision at the time this routine j \ \ -1 

fheh 


t!ll2 X and Y positions of the sprites and the si 


■3 I 2e r. ? 


Cl the a L 3yei 


sprite 3' 

coll 15ion 


'-lie pi 

ff used to decide which sprites are actually ; 

- hvolved in 


th 


C o fr« ui o > j u r 


9/15/02 

. ~ V. . mam 


P 3 2 J 





API 5 NOTE 1004 


COLLISION DETECTION 



EXPOSITION 


c 


The routine is called with one sprite defined as the PLAYER 
sprite. All collisions are reported in reference to the player. To 
increase the accuracy of collision detection, the SIZE of the player 
(the highest X and Y values that are non-transparent in this sprite) 
is also passed to the collision detection routine. 

The detection routine returns the number of collisions that 
the player is involved in. If the player in involved in NO 
collisions a zero will be returned, EVEN If THERE ARE OTHER 
COLLISIONS ON THE SCREEN I HAT l HE PLAYER ID NOT INVOLVED IN. 
sprite numbers of the other sprites involved in the collision 
returned in the 7 byte RESULTS array. Up to 7 collisions are 
p ossible. 

This routine should be called at the end of the frame (during 
vertical blank ins). If a rbster driven interrupt routine is b^ind 
used, this routine can easily become part of that routine. 



SOURCE LISTING 


W- 


1000 

1010 

1020 

1030 

1040 

1050 

1060 

10/0 

1000 

10V0 

1100 

1110 

1120 


.PAG 


r .v * .v .v .s .v xx x x x x x :c :c x x x x x x x x x x .v^ •>- -v .*.% .v 

?:<• COLLISION DETECTION 

R0UT1NL 

* V . 

r 

;•:< CALL THIS ROUTINE WITH THE .X REGISTER 
}X CONTAINING THE NUNDER OP THE SPRITE 
j •■{ 10 CHLCK ON 


, •' 



ret urns 


COUNT (NUfibLR Of COLLISIONS 
RESULT (A ? DYTE ARRAY OP 
(OPRlit. NUROERS 


) 

) 

) 








AFT NOTE 1004 


COLLISION DETECTION 


r 

K . 

I 


k> 


1130 

1140 

1150 

1160 

1170 

1100 

1190 

1200 

1210 

1220 

1230 

1240 

1250 

1260 

1270 

1200 

1290 

1300 

1310 

1320 

1330 

1340 

1350 

1360 

1370 

1300 

1390 

1400 

1410 

1420 

1430 

1440 

1450 

1460 

1470 

1400 

1490 

1500 

1510 

1520 

1530 

1540 

1550 

1560 

1570 

1500 

1590 

1600 

1610 

1620 

1630 

1640 

1630 

1660 

1670 

1600 


9/15/03 


r •< 

» y 

r rt A A A A . 


.\ .V A A .V A A A A 


VARIABLES 


x--$A3 

COUNT 

a — tv r I 


i NUMBER OT VALID COLLISIONS 

PLAYER 

* = S->1 


^SPRITE TO CHECK ON (PLAYER SPRITE) 

PXftAX 

tv — tv 1 1 


rMAXIMUM SIZE or PLAYER IN X DIRECTION 

PYi'lAX 

K-x :l 


}MAXIMUM SIZE OP PLAYER IN Y DIRECTION 

C0L1DE 

«=•:«•! 1 


r TEMPORARY STORAGE FOR COLLISION RESISTE 

TX 

*=x i-2 


r TEMPORARY SPRITE X POS STORAGE 

TY 

tv - tv • 1 


» TEMPORARY SPRITE Y POS STORAGE 

PLX 

•* — ;/ .». r y 

V. — tv i 


rPLAYER SPRITE X POSITION 

PLY 

•< — v. . 1 . 1 
.v* - wv i I 


?PLAYER SPRITE Y POSITION 

TEf'iP 

y -i.v • 4 
.vtv 1 X 



x=$F/ 

RESULT 

y — y .».*/ 
tv - tv 1 / 


JSPRITE NUMBERS Or VALUE COLLISIONS 

r 

} CONST ANTS 



T 

SPRX 

=$0000 



SPRY 

-$0001 



MSDX 

=$0010 



SPRSPR 

=$D01£ 



r 

*-$3000 


• 

r 

BANC 

LDA 9 $00 

?SET NUMBER Of COLLISIONS TO 0 

* 

STA 

COUNT 

1 

7 

LDA 

SPRSF'R 

r READ SPRITE- SPRITE COLLISION REG 


STA 

COL IDE 

r SAVE If 

r 

STX 

PLAYER 



LDA 

DO f S r X 



AND 

C0L1DL 

rPLAYER IN A COLLISION 

* 

3EQ 

EXIT 

;N0 

t 

JSR 

ADDR 

?get PLAYER POSITION 

r 

STA 

PLX 



LDA 

TX M 



STA 

PLX-i 1 



LOA 

TY 



STA 

PLY 


r 

LDX 

97 

?D0 EVERYBODY 

A G A 1 N 

CPX PLAYER 

i EXCEPT SELF 

DEO 

PI 


# 

r 

LDA 

AND 

DOlSrX 

COLIDE 

THIS ONL IN A coi i 

UULL1C10N ? 


DEO 

PI 

r NO 


L G iii »i O d Q p a 








APP NOTE 100/ 


COLLISION DET ECT10N 






1690 

r 




1700 


JSR 

ADDR 

?GLT X,Y POSITION 0T THE SPRITE 

1/10 

r 




1720 


SEC 



1730 


SBC 

PLX 

, COMPARE LOW ORDER X BYTES 

1740 


TAY 


f GAUL IT !• OR A WHILE 

1750 

r 




1760 


LDA 

TX-: 1 

JNOW THE NIG!! ORDLR 

1770 


SBC 

RLXil 


1700 


BCS 

CO ftp 

;TX-H>=PLX: 1- NO PROBLEftS 

1770 

r 




1000 


OTA 

TLftP 

JSAME NIC!! ORDER BITS 

1010 


TYA 


?GET LOU ORDER B1TG 

1020 


LOR 

FHFT 

'GET 2'S COftP (CARRY IS CLEAR) 

1030 


AOC 

M1 


10/0 


TAY 


JNEW SAME LOW ORDER BITS 

1050 

r 




1060 


LDA 

1 LftP 

fBRING FilGii ORDER BITS BACK 

1070 


LOR 

*t*r-T 


1000 


ADC 

ho 


1070 

r 




1900 

COftP 

BNE 

pi 

JNO COLLISION 

1710 


TYA 


r GL.r LOU ORDER GITS 

1920 


CftP 

PXftAX 

JIN RANGE ? 

1730 


iiCG 

pi 

fNO COLLISION 

19/0 

r 




1950 


SLC 


J NOW CHECK Y 

1760 


LDA 

TY 


1970 


ODC 

PLY 


1900 


BCS 

COftPY 

;CHECK IP IT IS NEGATIVE 

1770 

f 




2000 


LOR 

H*FF 

JIT IS, SO FLIP IT 

2010 


ADC 

Ft 1 

?(CARRY IG GET) 

2020 

T 




2030 

COflPY 

CftP 

PYftAX 

^COLLISION ? 

2040 


GC3 

PI 

;N0 

2050 

r 




2060 

?x WL 

F!AME 

A C0LL1CI0N -X 

f 

2070 

r 




2000 


INC 

COUNT 

; INCREASE H Or COLLISIONS 

2070 


LDY 

COUNT 

;ANO GAME If IN HIE 

2100 


CTX 

RESULT- 1,Y 

; RESULTS TABLE 

2110 

* 

r 




2120 

Pi 

DLX 



2130 


BPL 

AGAIN 


21/0 

* 

f 




2150 

LX IT 

RTS 



2160 

r 




2170 






2100 }* CAL G 3PRIfi£ LOCATION 

2190 ?« SUBROUTINE 

2200 r xx x x x x x x x x * * x :c x xx x x x s x x x x 


2210 t 

2220 ADDR 
2230 
22 <0 


T XA 
AGL 
! AY 


tel or f wLi to cr-rau positions 


9 / 15/02 


C o tii odor-: 


PSSi < 





APP NOTE 100'. 


COLLISION DETECTION 


2250 

r 







2260 


LDA 

OF'fsY , 

Y 



?GET Y COORD 

2270 


OTA 

' TY 




fsave IT 

2200 

r 







2290 


LDA 

fiCDX 




?GET SPRUE MIG!! 

2300 


AND 

DOTS, 

X 



?IS IF OEF ? 

2310 


OLD 

OK IP 




r NO 

2320 


LDA 

».l 





2330 

OK IP 

OTA 1 X-: 1 




F CAVE IT 

2340 

r 







2350 


LDA 

SPFvX r 

Y 



} GET X LOW ORDER 

2360 


OTA 

TX 




rSAVE IT 

2370 


RTS 






2300 

r 







2390 

DOTS 

.BYT 

tOl , $02 

!, £04 , ! 

tOO , 

$10,$20,$40,100 

2 400 

9 

f 







2410 

.END 







MEX 

OUrIP 









3000 

A9 00 

05 A3 

AD 

IE 

DO 

05 



3000 

A7 06 

A 4 BD 

01 

30 

25 

A7 



3010 

FO 54 

20 67 

30 

05 

AD 

A5 



3010 

A7 05 

AC AS 

AA 

05 

AD 

A 2 



3020 

07 El4 

A4 FO 

3E 

BD 

01 

30 



3020 

25 A7 

FO 37 

20 

67 

30 

30 



3030 

E15 AB 

AO A5 

A 9 

E5 

AC 

BO 



3030 

0£ 05 

AE 70 

47 

f- c 

I 1 

67 

01 



3040 

AC A5 

AE 49 

FF 

69 

00 

DO 



3040 

1A 73 

CS AS 

00 

15 

30 

A5 



3050 

AA L5 

AD BO 

04 

49 

f r 

69 



3050 

01 C5 

A 6 BO 

06 

E 6 

A3 

A/t 



3060 

A3 96 

F 6 CA 

10 

BD 

60 

OA 



3060 

OA AO 

07 01 

DO 

05 

AA 

AD 



3070 

10 DO 

3D 01 

30 

F 0 

02 

A 9 



3070 

01 05 

A7 07 

00 

DO 

05 

AO 



3000 

-60 01 

02 04 

00 

10 

20 

40 



3000 

00 







D AfA GTATEfiCNTG 


data 
data 
data 
DA TA 

data 

data 

data 

data 

data 

data 


V/15/V 


/C2 


169, 

0 , 

133, 

163, 

173, 30, 200, 

133 

167, 

134, 

164, 

107, 

127, 40, 37, 

167 

240, 

04, 

32, 

103, 

40, 133, 171, 

165 

16'? r 

133, 

172, 

165, 

170, 133, 173, 162 

7 t 

220 , 

164, 

240, 

62, 109, 129, 

40 

37 r 

16 7, 

240, 

55, 

32, 103, 40, 

56 

22 ? r 

171, 

160, 

165, 

169, 229, 17 

2, 176 

1 4 r 

133, 

174, 

152, 

73, 2oS, i q , 

1 

1 60 7 

165, 

174, 

73, 

2t»5, 105, 0 , 

200 

26 r 

152, 

177, 

165, 

i-76, 21 , 34 , 

165 





C 0 Cm iii O Oj u i" ,=* 



p.3Se_.^ 







APP NOTH 1004 


COLLISION Oi£T£CTICN 


DAI A 

170, 

229, 173, 

176, 

4, 73, 255, 105 

DATA 

1, 

197, ldd. 

176, 

6 r 

230, 163, 164 

DAI A 

163, 

150, 24d, 

202, 

16, 107, 96, 130 

DATA 

10, 

163, 105, 

1, 

200 

, 133, 170, 173 

DATA 

Id, 

200, dl, 

129, 

40 

, 240, 2, 169 

DATA 

1, 

133, 169, 

105, 

0, 

200, 133, 160 

DATA 

DATA 

9 d , 
120 

1 , 2 , 4 , 

0, 

Id, 

32, 64 


NLttORY/RLGlCTLR RLGlUIRLfiLNT 0 


This rout in* uses the accumulator, the .X and the .Y 
registers, and 2 bates on the stack. 1? locations on zero raa* 3 p e 


needed. The routine takes 13d bates o-f «emora. 


WORST CASH LXLCUTION TIiTil 


1055 cacles (1034 microseconds on a 1.02 tthz sastem) 


LXAilPLC? 
LI 


V/15/02 




LDA 

if 23 

OTA 

PXilAX 

LDA 

K21 

ST A 

PLYilAX 

LDX 

KO 

JSR 

BANS 

LDA 

COUNT 

li£Q 

SKIP- 

LDX 

COUNT 

LDA 

RliSULT,X 

JON 

LXF'LOD 

DSC 

COUNT 

DF'L 

AGAIN 

LDA 

HO 

JSR 

iIXPLOO 

f(TO 


2 



JOLT F'LAYLR 01ZL 


JCHLCK ON CPR1TL ttO C0LL1010NC 


JANY C0LLI010N0 ? 

JNO 

JOLOW UP LVLRYONL IN C0LL1010N 
JOLT NUrtSLR OP SPRITS TO LXPLOCl 
; (DO LXF'LOOION R0UT1NL) 


;NOW GLOW F'LAYLR UP 


C 0 fti iii odOi' 


P3 3e d 











APP N0Tc£ 1004 


COLLISION DETECTION 



NOTE; Remember that sprite to sprite collisions can take place even 
off screen. 

ADO 11 ION; Center Collision Detection 

ABSTRACT; 

The following mod if i cat i on of the collision detection routine 
dives the ability to use the center of a sprite to check collisions 
rather than the top left corner. Instead o-f the valid collision 
3re3 centering on the upper left corner of the player sprite.the 
valid collision area will be centered on a point within the sprite-. 

EXPOSITION 


1 he modification to the routine is confined to two areas; that 
i y r tne o edition ol* 2 c on s t o i~t u s uescrioind the center location of 3 
sprite and modification of the sprite location subroutine to use 
this center. 


SOURCE LISTING 


C 



source 
1 DUO . 

1010 ; 
1020 ; 

10 JU r 
1040 ' 
lUbO r 
1060 ' 


LISTING 
PAG ’CBANC’ 

.. .. ./ ./ V •/ V V V V V V v •/ •/ v V •/ •/ v V V •/ V ■/ V Y '* 
X ; X 'A .v .% ••• ••• ••• ••• A .V •*. A A A A .. A 

* COLLISION DETECTION 

.v ROUTINE 

l CALL i HIS ROUTINE Will! 1 HE 


x Register 



page 7 


C u miti Odor A 


•?/lb /02 
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COLLISION DETECTION 


1070 

1000 

1090 

1100 

1110 

1120 


r ■' 

* ••• 
r •' 

i y 
7 A 


CONTAINING l 
10 CMLCK ON 


NUMBER Oi* THE SPRITE 


PETURNS COUNT (NUMBER OT 

RESULT (A 7 BYTE ARRAY Oi* 
(SPRITE NUMBERS 


) 

) 

) 


1130 

1140 

1150 

1160 

1170 

1100 

1190 

1200 

1210 

1220 

1230 

1240 

1250 

1260 

1270 

1200 

1290 

1300 

1310 

1320 

1330 

1340 

1350 

1360 

1370 

1300 

1390 

1400 

1410 

1420 

1430 

1440 

1450 

1460 

1470 

1400 

1490 

1500 

1510 

1520 

1530 

1540 

1550 

1560 

1570 

1500 

1590 

1600 

1610 

1620 


7 

; VARIABLES 


7 

x=$A3 

COUNT 

:* — :* • i 

A "* A 1 X 


PLAYER 

X: = X !• 1 


F'XMAX 

•x - •:< -s i 


PYiAX 

:o=x :-l 


COLIDE 

*.\ — ‘A * i 


TX 

x-x :*2 


TY 

A “All 


F'LX 

y mm i* 1 O 

A — A 1 C. 


PLY 

v. — v. i. i 

A *• A 1 X 


TEMP 

y — y i 4 
•S All 


x=$r 7 
RESULT 

y M y i ~J 

A - A » / 


FCONST ANTS 


SPRX 

= $DGOO 


SPRY 

=•$0001 


MSBX 

= $D010 


3 P R S P R 

= $D01E. 


XCENT 

= 12 


YCEN T 

= 11 


7 

x--13000 


7 

CBANG 

LDA (HOD 


3TA 

COUNT 

7 

LDA 

SPRSPR 


STA 

COLIDE 

7 

STX 

PLAYER 


LDA 

DOTS r X 


AND 

COLIDE 


3EQ 

EXIT 

« 

7 

JSR 

ADDR 

r 

r 

ST A 

PLX 


LDA 

TXM 


STA 

f'LX-! 1 


LDA 

TY 


STA 

PLY 


9/15/02 


•/ v v v ■/ v v v v v •/ •/ •/ •/ •/ v •/ v v v v v 

>\ A A A A A A A A A A .V .V A A A .V A A A 


JNUMBER OT VALID COLLISIONS 
FSPRITE TO CHECK ON (PLAYER SPRITE) 

JMAXIMUM SIZE OT PLAYER IN X DIRECTION 
rMAXIMUM SIZE OS* PLAYER IN Y DIRECTION 
rlEMPORARY STORAGE FOR COLLISION REGISTER 
;TEMPORARY SPRITE X POS STORAGE 
;TEMPORARY SPRITE Y POS STORAGE 

JPLAYER SPRITE X POSITION 
rPLAYER SPRITE Y POSITION 


FSPRITE NUMBERS Of VALUE COLLISIONS 


rSf'RITE CENTER X 
;SPRITE CENTER Y 


;SET NUMBER Of COLLISIONS TOO 


^'NIT E-SPR11 E COLLISION 

7 O A V tl If 


REG 


FF’LAYER IN A COLLISION 
NO 

;get player position 


Co aw.; odor* 


p 3S* 


0 






APP NOTE 1004 


COLLISION DETECTION 




r' 



1<S30 *, 


1440 


LOX 


ti 7 

;D0 EVERYBODY 

1450 

AGAIN 

CPX 

PLAYER 

} EXCEPT SELF 

1440 

14/0 

r 

PE Cl 


PI 


1400 


LDA 


DOTS, X 

; IS THIS ONE IN A COLLISION ? 

1490 


AND 


COLIDE 


1700 

1/10 

r 

PEG) 


PI 

} NO 

1720 

1730 

r 

JSR 


ADDR 

)GET X,Y POSITION OT THE SPRITE 

174 0 


SEC 




1750 


SPC 


PLX 

jCOMPARE LOU ORDER X BYTES 

1740 

1770 

r 

TAY 



rGAVE IT FOR A WHILE 

1700 


LDA 


TX; 1 

?NOW THE HIGH ORDER 

1790 


SOC 


PLX i-l 


1000 

1010 

» 

r 

PCS 


COMP 

;TX>1>=PLX:1- NO PROBLEMS 

1020 


STA 


TEMP 

?SAVE HIGH ORDER PITS 

1030 


TYA 



t GE T LOU ORDER DITG 

104 0 


LOP 



?GET 2'S COMP (CARRY IS CLEAR) 

1050 


AOC 


HI 


1040 

1070 

r 

TAY 



}NEW SAVE LOW ORDER PITS 

1000 


LDA 


TEMP 

JBRINC HIGH ORDER PITS PACK 

1090 


EOR 


H*FF 


1900 

1910 

r 

ADC 


HO 


1920 

COMP 

PNE 

PI 


} NO COLLISION 

1930 


TYA 



;GET LOU ORDER SITS 

1940 


CMP 


PXMAX 

;IN RANGE ? 

1950 


GCG 


PI 

;N0 COLLISION 

1940 

1970 

* 

7 

SEC 



;NOW CHECK Y 

1900 


LDA 


TY 


1990 


SPC 


PLY 

r CHECK IF IT IS NEGATIVE 

2000 

2010 

9 

r 

PCS 


COMPY 


2020 


LOR 


Ktf r 

;IT IS, SO FLIP IT 

2030 


ADC 


HI 

; (CARRY IS GET) 

204 0 

9 

7 




JCOLLISION ? 

2050 

COMPY 

CMP 

PYMAX 

2040 


DCS 


PI 

f NO 

2070 

r 





2000 

; -:c WL 

HAVE 

A 

COLLISION a 


2090 

2100 

2110 

2120 

9 

7 

INC 

LDY 


COUNT 

COUNT 

; INCREASE H Of C0LLlSlOi lr - 
, AND GAVE IT IN THE 


SIX 


RESULT• 1 , Y 

; RESULTS TABLE 

2130 
214 0 


DLX 


AGAIN 


2130 


GPL 


• 

2140 

2170 

exir 

RT3 




2100 

r 






t 



9 / 15/&2 


F3SC V 


C o fu iii o Ci Ci r c 
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COLLIGION DETECTION 


c 


2190 

2200 

J 5 CALC GRR 

1TE LOCATION 


2210 

2220 

2230 

2240 

j:< SUBROUTINE 
;x- (FROrl CENTER) 


* 

r 



2250 

ADDR 'IXA 


JGL1 OFTCLT 10 SPRUE 

2230 

AOL 

A 


2270 

1 AY 



2200 

r 



2290 

CLC 



2300 

LDA 

SF*RY i Y 

JOLT Y COORD 

2310 

ADC 

HYCENT 

J CENTER IN Y DIRECTION 

2320 

OTA 

1 Y 

JCAOL it 

2330 

T 



2340 

LDA 

dOBX 

JGLT OF’Rll L HIGH ORDLR 

2350 

AND 

oorsrX 

JIG IT GET ? 

2330 

BLQ 

OK IF* 

J NO 

2370 

LDA 

HI 


2300 

OK IF 1 OTA 

1 X-: 1 

J CAVE n 

2370 

r 



2400 

OLD 



2410 

LDA 

OF'RX r Y 

JOLT X LOW ORDLR COORD 

2420 

ADC 

StXCENT 

JADD X CENTER 

2430 

OTA 

TX 

J0A9E IT 

2440 

LDA 

TX> 1 


2450 

ADC 

HO 


2430 

3TA 

TXM 


2470 

r 



2400 

RTS 



2490 

r 



2500 

DOT 0 .BYT 

it-01 r $02 f $04 i iOO t 

$10 r $20 r $4 Or $C0 

2510 

* 

r 



2520 

.END 




t 




HEX OUilR 


3000 

A 9 

00 

3000 

A7 

03 

3010 

TO 

54 

3010 

A 7 

05 

3020 

07 

E4 

3020 

25 

A7 

3030 

E5 

AB 

3030 

OE 

05 

3040 

AO 

A5 

3040 

1A 

70 

3050 

aa 

L5 

3050 

01 

C5 

3030 

A3 

93 

3030 

OA 

AO 

3070 

Ob 

aa 

3070 

FO 

02 


05 A3 AD IE 
A 4 SO 00 30 
20 37 20 05 
AC A5 AA 05 
A4 FO 3E OD 
FO 37 20 37 
AO A5 A9 E5 
AE 70 47 FF 
AL 49 F f 39 
C3 A3 SO 13 
AD 00 04 49 
A3 SO 03 So 
F 3 CA 10 L '0 
10 S7 01 00 
AD 10 DO 3D 
A7 01 03 A7 


DO 

05 

25 

A7 

AD 

A5 

AO 

A2 

OD 

30 

30 

30 

AC 

BO 

37 

01 

00 

DO 

30 

A3 

F r 

39 

A3 

A4 

30 

OA 

37 

OS 

OD 

30 

10 

S7 
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3000 

00 

DO 

69 

OC 

Ob 

AC 

Ab 

A 9 

3000 

67 

00 

03 

A 7 

60 

01 

02 

04 

3070 

00 

10 

20 

40 

00 





DATA GTA TEilENTG 


DATA 

169 r 

0 , 

133, 

163, 173, 30, 200, 

133 

DATA 

1 6 7 r 

134, 

164, 

107, 141, 40, 37, 

167 

DATA 

240r 

04, 

32, 

103, 40, 133, 171, 

165 

DATA 

167, 

133, 

172, 

165, 170, 133, 173, 162 

DA 1 A 

7, 

220 , 

164, 

240, 62, 109, 141, 

40 

DATA 

37, 

167, 

2 40, 

53, 32, 103, 40, 

36 

DATA 

229, 

171, 

160, 

165, 169, 229, 17 

2, 176 

DATA 

14, 

133, 

174, 

132, 73, 233, 103, 

1 

DATA 

160, 

165, 

174, 

73, 25b, 105, 0, 

200 

DATA 

26, 

152, 

177, 

165, 176, 21, 36, 

163 

DAI A 

170, 

229, 

173, 

176, 4, 73, 255, 

105 

DATA 

If 

177, 

166, 

176, 6, 230, 163, 

16 4 

DATA 

163, 

150, 

24 6, 

202, 16, 107, 96, 

1 bo¬ 

DATA 

10 , 

160, 

24, 

105, 1, 200, 105, 

il 

DAI A 

133, 

170, 

173, 

16, 200, 61, 141, 

40 

DATA 

2 40, 

2 , 

167, 

1, 133, 167, 24, 105 

DATA 

0 , 

200 , 

105, 

12, 133, 160, 165, 

169 

DATA 

103, 

0 , 

133, 

167, 76, 1, 2, 4 



DATA Or 16, 32 r 64 


120 


ilEi'IOPY/PEGIGTEP PEOUIPEilENTG 


This routine uses the accumulator r the .X and the . Y 
red i stars» and 2 bytes on the st^ck. fhe routine requires 17 bytes 
oT zero pase Fv A ft storage. The program takes 140 bytes of m e m o r y, 

Jjofisr CAGE EXECUTION TIflE 

I'sAb cycles (1220 microseconds on a 1.02 flhz system) 


4 



LL : M 

It is possible for this routine to report false coll i s i o r. 5 in 
the c3Sl > of two or more sprites bavins some part in the 5re3 defined 



9/15/° 2 


C o fii fii odor e 


pase 11 
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ba the player size. 1 he follow ins picture makes this clear? 






APP NOTE 10CK 


COLLIG1OK DETECTION 


0 0 

G 11 

AAAAAAABAAAAA b 

A 

A A 

A 

A PA P 

A PA P 

AAAAAAAAPAAAA P 

i*i »*. 

r r 

pppppppppppp 

As you can see. the player is colliding with sprite A only. 

Out sprite A is colliding both with the p layer and with sprite El. 

•Jhen the collision detection routine is called/ it will report that 
the player is in collision with DOTE! A and Or since each is involved 
in 3 collision 3t the tinier and both are within the size of the 
p1 3 yer sprite. 


0. 


SPRITE 10 BACKGROUND COLLISION DETECTION 


ABSTRACT 

This routine will translate the (XrY) coordinates oT the 
position of a sprite to background collision into a row/column 
address on the video matrix. IT the sprite center is off screen, an 


£ P P 0 P 

i s 

fla 3Sed. 

The 

coordinates 

of the sprite are in the normal 

r s n 2 * 

o-r 

0>=X>~511 

a n d 

0>~Y>= : 2S5. 

The row/c olumn address is j - 

ran^e 

0> 

-X>~3? and 

0>-Y 

>■24. 



( 

V. 


l xposition 

Often in a program it is necessary to know not onlu +. , 

L = wiat a 

.ii^ion between a sprite and background data took ? hr. 
coIl 131 ° l3c «- but where 

took rl*« 35 " aU ‘ K oras tht f5ct 3 “UUi 01 , took pUo , 

C G lit ih OmOPis 


is 




U 



4 



app note: ioo< 


COLLISION DETECTION 


is needed by 3 proirsiir this pout ins is unnecessary t ss the 
s f r i t e ■ background collision r e £ i s t e r in s y be used 31 o n e in that csss. 
Howeverr if the location of the collision on the screen is needed 
(to ss* exactly wh31 the sprite hi-tr for exs«Fli), the following 
routine C3n be useda 

This routine is one approach to the problem. There 3re some 
rather important limits to this routine* however. See the LIMITS 
sect i o i'i (below) •for wore i nfor ■■■ st i on • 


SOURCE LISTING 


1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1000 
1090 
1100 
1110 
1120 
1130 
11(0 
1150 
1160 
1170 
1100 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1200 
1290 
1300 
1310 
1320 
1330 
134 0 


.PAG ’CORD ' 


;x BACKGROUND COLLISION 
;x ROUTING 

v vvvvvyvvyv Y..YL v v v v w y v v v v v y v v, 
} A- A .v A A A A X .V .V.V A A A A A AAA A .V A A A X 


; CONSTANTS 


CPRX 

-$D000 

?VIC CHIP RLG1CTLRC 

SPRY 

=$0001 


NCIGX 

=$D010 


SPRGAK 

= $ 0 01F 

\ 

xof r 

-0 

; CCRLLN CLNT LR1NC CONST ANTC 

Yorr 

=3 



•{ = $0002 
r 

XC •:<=* ! 2 

YC x-xM 


)2 BYTL X C00RDINATL 0T SPRITL 
r Y C00RD1NA TE OF SPRITE 


:-$3000 


}« 


r 

i :* 

r ••• 

i •/ 

r •' 

* •< 

r 


, „ v v V v •/ v V v V v V y V •/ • 

“pRirrrrsACXfiaouNo'coLLxaioii'RouriMf 

LN1ELR THIS ROUTING WIT N 1UL OPRllL 
NUMBER TO CHECK ON IN •i 


T ML COORDINATES ARC JLlUfCNLD IN -X (ROW) AND .Y (COL) 
CARRY WILL BE CLEAR L.i A uOOO ^ ------- 


CARRY WILL E)L SU IF WRITE 1C Off CCRLLN 


9/15/02 


Coaaodore 


Pas* l 


i -t 







AFT NOTE 1004 


COLLISION DETECTION 


1 Jb'U 
1360 
1370 

r Oft 

if rii 

ERE 13 NO COLLI3 

ION 

V 

r 




1300 

CORD 

LDA 

SPRBAK# 


1390 


AND 

DOTGrY 


1400 

1410 

V 

r 

BEQ 

EXIT 

FNO C0LL1CI0N WITH THIS SPRITE 

1420 


1 YA 



1430 


ACL 

A 

F SET POINTER FOR SPRITE REC1CTERC 

1440 

1450 

r 

TAX 



1460 


SEC 



1470 


LDA 

CPRXrX 

; DO X F 1RCT 

1400 


33 C 

Ft2 4 s-XOPP 

F3UD FRAC r SCREEN OfPOET 

1490 


STA 

XC 


1500 


LDA 

MCI OX 

FHANDLE MOB OT CF'RITL 

1510 


AND 

DOTOrY 


1520 

1530 

r 

BEQ 

SKIF'l 


1540 

1550 

r 

LDA 

K1 


1560 

SKIF‘1 

SBC 

KO 


1570 


STA 

XC : 1 

FHANDLE HIGH BYTE 

1500 

1590 

r 

3CC 

EXIT 

FSPRITE 13 0J*SCREEN 

1600 


BEQ 

CKIF'2 

FSPRITE IS ON LETT SIDE Of SCREEN 

1610 

1620 

T 

LDA 

XC 

FOTT SCREEN ? 

1630 


CMP 

tt$56 


1640 

1650 

r 

BCS 

EXIT 

FYLS 

1660 

SK1F‘2 

LSR 

XC-: 1 

FDIVIDE BY 0 

1670 


LDA 

XC 


1600 


F40F4 

A 


1690 


LOP 

A 


1700 

1710 

r 

LOfv 

A 


1720 

1730 

r 

1 AY 


FPREPARE IT FOR RETURN 

1740 


SEC 


FNOW DO Y COORD CONVERSION 

1750 


LDA 

SPRY,X 


1760 


SBC 

«50:YOFF 

F (WHERE YOF T IS FROM 0-7) 

1770 


3CC 

EXIT 

FSPRITE IS OPP SCREEN 

1700 

r 




1790 


CMP 

ti 25 0 • 50 

F OT F THE BOTTOM ? 

1300 


3C3 

EXIT 

FYEO 

1010 

n 

r 



FD1V1DE BY 0 

1020 

1330 


LSR 

LSR 

i r-r. 

A 

A 

A 

1040 


LbK 

R 


1353 

1060 

r 

r 

TAX 


Ff'ASC IT BACK IN X 

1370 

1000 

* 

r 

CLC 

»*• T O 


FSHOW OOOD EXIT 

1390 


jS. 1 J 



1900 

* 

r 
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1910 

LX1T 

OLC 

; ERROR LX IT 

1920 


pro 


1930 

r 



1940 

DO TO 

1 — 
>- 
Zd 

m 

$01 r £02 , £04 , tOO , £10 , *20 , £40 , £00 

1950 

r 



1960 

. LND 




HEX 

OUilP 




. 







3000 

B9 

IF 

DO 

39 

47 

30 

F 0 

3D 



3000 

90 

OA 

AA 

30 

00 

00 

DO 

E9 



3010 

10 

05 

02 

AD 

10 

DO 

39 

47 



3010 

30 

KO 

02 

A 9 

01 

E9 

00 

05 



3020 

03 

90 

22 

F 0 

06 

A5 

02 

C9 



3020 

56 

00 

1A 

46 

03 

A 5 

02 

6A 



3030 

4A 

4 A 

AO 

30 

BD 

01 

DO 

L9 



3030 

35 

90 

OA 

C9 

CO 

00 

06 

4 A 



3040 

4A 

4 A 

AA 

10 

60 

30 

60 

01 



3040 

02 

04 

00 

10 

20 

40 

00 



DATA 

GTATLtt 

ONTO 





DATA 

105, 

31, 

200, 

57, 

71, 40, 

240, 61 

DATA 

152, 

10, 

170, 

56, 

109, 0, 

200, 233 

DATA 

24, 

1 JjZ r 

2, 

173, 

16, 200, 

57, 71 

DATA 

40, 

240 r 

2, 

169, 

1, 233, 

0, 133 

DATA 

3, 

1 4<r 

r 

240, 

6, 165, 

2, 201 

DATA 

06, 

I76r 

26, 

70, 

3, 165, 

2, 106 

DATA 

74, 

74 r 

160, 

56, 

109, 1, 

200, 233 

DATA 

\ 53, 

14 4 r 

10, 

201, 

200, 176 

1 , 6, 7 4 

DATA 

74, 

74 r 

170, 

24 , 

96, 56, 

96, 1 

DATA 

2, 

4 r 0 

, 16, 

32, 

64, 120 



fiLfiQRY/RLGICTLFv FvEOUIFiLPiLNl C 


This routins usss the accuftiulatoi , the 
registers. The routine requires 3 bytes of 
1 he routine takes up 70 bytes of Memory. 

WOPOf CAOlZ EXECUTION TlfNi 

1 ^ / £j Ji n fii ui n •“« ”1 i .r’.. . 


• X 31 - 1 .-J the .Y 

1=5, 0 •' 3 3 3e iiAil stor3de. 


o » 


d & 


^ /• 












APT’ NOTE 1004 


COLLIOION DETECTION 


100 cycles (VO m i cr o seconds in 3 1.02 Whz system) 


Llill TO 



limits on this routine. The problem is th3t 3 sprite takes up 



when expanded. The sprite to backaround collision could be anywhere 
in that V (or 10) character ares that the sprite is covering. It is 
difficult to tell, where the collision 3ctu3lly took place. 

I here are several solutions to the problem, none completely 
sat i s factory. fhe d3t3 making up the '? (or 10) characters could be 
compare with the data making up the sprite. However, this approach 
can lead to serious processing time, especially if the sprite does 
not happen to be on a character boundary. 

One possible solution is to allow only certain characters 
could be allowed to cause a collision. Lach of the V (or ID) 
characters possible must be checked on the screen for this to work 
IT the size of the sprite is precisely known, the number of 
characters to be checked might be reduced. 

Another approach (which will be used in the following *.• = , •, . 

A <3 hi r L vj ) 

defines a 'critical area', a one character center of the sprit* 
which we use as the key spot to inspect on the video matrix ‘if 
approach works best when the background objects on the ~ r «- 

o C i £• c. 


1hsre ft.siVw* oth*r approach 
.- nil t h *2 Iodic of r S 3 t O f t !"| >=i 

{? £I < *-* 




17 






API 5 NOTE 100 4 


COLLISION DETECTION 


IMPORT ANT NOTE? If multi-color characters are used* the problem can 
he reduced ha makins non-critical objects (objects which should not 
cause collisions) in 01 multi-color. 1 he 6566/656? chip will not 
report 3 collision between a sprite and 3n object of this color (hit 
pattern). 


EXAMPLE 1 

CometiWes more information than the screen matrix address of 
the sprite is needed. The follow ins example uses the row and column 
returned by the sprite to background collision detection rout in-- =>nd 
sets the character under the top left corner of the sprite. 


SOURCE LISTING 


.% .% A A A . 


'CKDACiC 1 

1010 ; 

1020 

1030 BACKGROUND COLLISION 
1040 
1050 
1060 
1070 
1000 


1130 

1140 

1150 

1160 


1190 


1220 


9/15/02 


F CONSTANTS 

OPRX 

=•*0000 

SPRY 

--•1D001 

MSIGX 

=•*0010 

SPRI3AK 

* 

-*D01i r 

f 

XOT f 

= 0 

YOPi* 

=3 

jr 

SCREEN 

=*0400 

LLEN 

-40 

XCENT 

-1 

ycent 

= 1 

LINLO 

^SCREEN 

linei 

-LINED:LLEN 

LINE 2 

= L1NE1-: LLEN 

>2 



?V1C CHIP REGISTERS 

JGCRECN CENTERING CONSTANT^ 

;CENTER Of SPRITE IN f. ( -, |1/fA 

f '0L/C0L f OR ft 

? SCREEN ROl-J CONST ANTE 

C o m m o d o r e 


pS se 10. 












APP NOTE 1004 


COLLISION DETECTION 


12<S0 LINC3 
1270 L1NE4 
1200 LINL5 
1290 LINE6 
1300 LINC7 
1310 LINES 
1320 LINE9 
1330 LINE10 
1340 LINL11 
1350 LINE12 
1360 L1NL13 
1370 LINE14 
1300 LINE 15 
1390 LINE16 
1400 LINCI7 
1410 LINE10 
1420 LINE 19 
1430 LINE20 
1440 LINE21 
1450 LINE22 
1460 L1NL23 
1470 LINE24 
1400 ; 


-L1NE2-:LLLN 
-LINES i-LLEN 

- L1NL4-! LLLN 
-LINES i-LLEN 
-L1NL6-! LLLN 
-LINE/ i-LLEN 
“L1NL0-: LLEN 
=LINE9 i-LLEN 

- L1NL10-: LLEN 
^LINEll i-LLEN 
“LINL12-: LLEN 
•=LINE13-!-LLEN 
“L1NE14-! LLEN 
-LINE15 i-LLEN 
r LlNC16-: LLLN 
=LINE17 i-LLEN 

- L1NE10-: LLEN 
-LINE19 s-LLEN 
=L1NC20+LLLN 
-LINE 21 s-LLEN 
r LINE22-: LLLN 
-LINE23 i-LLEN 


1 490 ; VARIABLES 
1500 

1510 x~$0002 
1520 ; 

1530 XC •:«=*•! 2 

1540 YC K = :t M 

1550 PTR K = « i2 

1560 ; 

1570 * = 4-3004 


1500 .PAG 


',2 BYTE X COORDINATE OT SPRITE 
t Y COORDINATE Oi- SPRITE 
f T 0 CET TO SCREEN 


; 


1590 

1600 

1610 

1620 


.% .V .v .V ,v A , 


•/ •/ y v v 

A A A A A 


A A . 


EXAMPLE Oi* USING T!IE Si :, RITE 
TO BACKGROUND COLLISION ROUTINE 


1630 
16 40 
1650 
1660 
1670 
1600 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1700 
1790 
1000 
1010 


;•:< T ML .Y REGISTER MUST CONTAIN T ML 
SPRITE TO SE CHECKED. 

f V 

r ^ 

;•:« THE CHARACTER CORRESPOND INC TO THE 
i » SPRITE CENTER IS RETURNED IN .A 

« y 

r * 

;z If THERE IS NO COLLISION T HE CARRY IS 
fX SET. 

, V :* v y •/ ■/ V v •/ V •/ 'f •/ V V V V •/ •/ y V y •/ ■/ •/ •/ •/ •/ •/ V V V y y •/ V y y V 


CKBACK JSR 
DCS 

CORD 

NOCOL 

!rM. ND ^ r ‘ Rnx ON 01DL0 MAT Ply 
ffiiL Si’RIlL. IS OP;-* r * *. - „ ^ 



f or therl is no Lollici^^ 

' T YA 


; 0L] COLUMN NUMBER 

CLC 


ADC 

HXCLNT 

!A0D ,0 cemilr ot scinu <0 2 



9 / 15 / 0 ^ 


i’adia 


C 0 III i'll 0 U 0 p £• 







Af'P NOT E 1004 


COLLISION OCT LOTION 


1020 

r ay 



1030 ; 




1040 

TXA 


F CLT ROW NUfiDER 

1050 

CLC 



1060 

ADC 

HYCENT 

FADD 10 CLNTLR OF CPRITL 

1070 

TAX 



1000 ; 




1090 

LDA 

CCRLOW t X 

FCLT FOR INDIRECT ACCLCC 

1900 

OTA 

PTR 


1910 

LDA 

CCRfil r X 


1920 

STA 

PTRM 


1930 I 

I 

f 



1940 

LDA 

(PTR)rY 

F GET TF!L CHARACTER 

1950 

RT3 



1960 




1970 

OCOL 3EC 



1900 

TO 



1990 




2000 




2010 

■t SPRITE TO 

BACKGROUND 

COLLISION ROUTINE 

2020 

y 

V. 




2030 
2040 
2030 
2060 
2070 
2000 
2090 
2100 
2110 
2120 CORD 
2130 
21 <0 
2150 ; 

2160 
2170 
2100 
2190 F 
2200 
2210 
2220 
2220 
2240 
2250 
2260 
2270 ; 

2200 
2290 F 
2300 CKlf'l 
2310 
2320 
2330 ; 

224 0 
2350 F 
2360 
2370 


ENTER 1H1C R0UT1NL WITH 1 ML SPRITE 
NU.iflER TO CHUCK ON IN .Y 


x THE COORDINATES ARL RETURNED IN =X (ROW) AND .Y (COL) 
* CARRY WILL BE CLEAR ON A GOOD RETURN 
X CARRY WILL BE CLT IF CPRITL 1C Off CCRLLN 
x OR IP THERE 10 NO COLLISION 

y y y. y v y v ■/ v v y v v v ■/ •/ v •/ ■/ v •/ v v v •/ v y *f v f v •/ v ’f ■' 'Y “Y '( 'J *Y 
A A .V A A .\ .V A A A A A A A A A A A A A A A A A A .V A .V A .V A .V A A A .V A A A A A A 


LDA 

CPRDAKHf 


AND 

DOTS r Y 


CEO 

EXIT 

FNO COLLISION WITH 1H1£; 

TYA 

ACL 

A 

F CLT POINTER FOR SPRITE 

TAX 


oLC 

LDA 

SPRXrX 

F DO X FIRCT 

SBC 

,12 4 i-XOPi" 

? 3U8 TRAl 1 SCftcIEN Ol’Toci’ 

CTA 

XC 

; HAitDLL ttOfc Of SPRITE. 

LDA 

ttSIGX 

AND 

DOTS r Y 


DEO 

SKI PI 


LDA 

HI 


etc 

HO 

rMANuLL Hit,*! L % .Y*|Q 

CTA 

XC-: 1 

see 

EXI f 

IU orj- scn sa , 

DEO 

CK1P2 

iCf'fUU 1C ON' Uf T o 1DL 

LDA 

XC 

? OF F SCREEN ? 

C/1P 

H*56 



Of CCRLLN 


'/15/02 


Cofiimocfor e 


psg* 20 












A Pi-- NOTE 1004 


COLLISION DETECTION 


2300 

2390 

r 

BCO 

EXIT ;YEO 

2400 

OKI F‘2 

LOR 

XC-: 1 ? DIVIDE OY 0 

2410 


LOA 

XC 

2420 


ROR 

A 

2 430 


L3R 

A 

244 0 
2450 

r 

LOR 

A 

2460 

2470 

7 

TAY 

;PREPARE it for return 

2400 


OLC 

? NOW DO Y COORD CONVERSION 

2490 


LDA 

SPRY r X 

2500 


SBC 

K50-SY0FT } (WHERE YOFf 10 FROM 0 ?> 

2510 

2520 

r 

see 

EXIT rSRRIfE IS OFT SCREEN 

2530 


CftP 

8250- 50 ;OFT U!L DOTTOfi ? 

2540 

2550 

r 

ocs 

EXIF YES 

2560 


LOFv 

A JDIVIDE BY 0 

2570 


L3R 

A 

2500 


LOFv 

A 

2590 

r 



2600 

2610 

r 

TAX 

;F’ACC n back in x 

2620 

2630 

2640 

r 

CLC 

RTS 

rOHOW GOOD EXIT 

2650 

EXIT 

CEC 

;ERROR EXIT 

2660 

2670 

* 

I 

RTS 


2600 

2690 

DOTO 

7 

• BYT 

$01,$02r$04,$00,$10,$20,$40,$00 

2700 

OCRLOW 

. BYT 

<LINEO , CLINLlr <LINE2r CL1NE3, <L1NE4, <L1NE5, 

2710 


. OY X 

'.LINE7, < LINES t <LINE9 , ‘ : %L1NE10 ,'\LINEl 1 , •sLINEl'^ 

2720 


. BYT 

<L 1NL14 r <L 1NL15»<L 1NE16, <L 1NL17 , <L 1NE10, <L 1NL19 

2730 
274 0 

7 

. 3Y r 

<LINE21,<LINE22, <LINE23,<LINE24 

2750 

OCfvF! 1 

. BYT 

>L1NL0, >L1NL1, >L1NL2, >L1NL3r >L1NL4, >L1NL5, 

2/60 


. 3Y r 

LI NE 7 , s 'LI NES , s LINE9 , ** LINE10 , s LINE11 , ,>LINE1 ’* 

2770 


. OYT 

>L1NE14,>LINL15,>L1NE16,>LINE17,>L1NL10,>L1NL1^ 

2700 

2790 

2000 

[end 

. OY r 

>LINE21 ,>LITT£22f>LIN£23f>LINE24 


• L 1 fvt_u 

XINE13 

: :L1NL20 


>line6 

: UNE13 

>E1NC20 


DU fif* 


3004 

3000 

J010 

3010 

JU20 

3020 

J030 
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20 

22 

30 

00 





17 

90 

10 

69 

01 

AO 

OA 

10 

69 

01 

AA 

00 

71 

30 

03 

05 

BD 

OA 

30 

05 

06 

01 

05 

60 

30 

60 

09 

IF’ 

DO 

39 

69 

30 

F 0 

3D 

90 

OA 

AA 

30 

OD 

00 

DO 

E9 

10 

05 

02 

AD 

10 

DO 


C 0 fit m O *"J G r * 


pad* 21 










NO PE 1004 


COLL 10ION OLTilCTICN 


3030 

39 

69 

30 

F 0 

02 

A 9 

01 

L9 

3040 

00 

03 

03 

•70 

22 

FO 

06 

A3 

3040 

02 

09 

06 

DO 

1A 

4 6 

03 

AO 

3050 

02 

6A 

4 A 

4A 

AO 

30 

3D 

01 

3000 

DO 

L9 

30 

90 

OA 

C9 

CO 

DO 

3060 

06 

4 A 

4 A 

4 A 

AA 

10 

60 

30 

3060 

60 

01 

02 

04 

00 

10 

20 

40 

3070 

00 

00 

20 

50 

70 

AO 

CO 

FO 

3070 

10 

40 

60 

90 

00 

LO 

00 

30 

3000 

50 

00 

AO 

DO 

FO 

20 

40 

70 

3000 

90 

CO 

04 

04 

04 

04 

04 

04 

3090 

04 

05 

05 

05 

05 

05 

03 

06 

3090 

06 

06 

06 

06 

06 

06 

07 

07 

30A0 

07 

0/ 

07 







DAT A OT A TLfiLNl 0 


DATA 
DATA 
DATA 
DAI A 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DAI A 
DATA 
DATA 
DATA 
DAI A 
DA l‘A 
DATA 
DA f A 
DAT A 
DATA 


02 , 
23, 
100 , 
109, 

0 0 r 

240, 
200 , 
57, 
Ox 


200 , 

6 r 

96, 
120, 
24, 
00, 
102 , 
4, 

6, 

7, 


34, 40, 

102. 24, 

r lx 170, 
r 130, 40 

'76, 105, 

■ 61, 152 

233, 24 

100, 40, 

133, 3, 

201, 06, 
106, 74, 

233, 03 

74, 74, 

1 , 2, 4 

0, 40, 

64, 104, 

120, 160 
19 2 , 4 , 

5, 5, 5, 

6 , 6 , 6 , 
7, 7 


1, 16 0, 

113, 40, 


176 

100 , 

10 ' 7 , 

, 135 , 6 , 17 /, 

31 , 200 , 0 7 , 

, 10 , 170 , 06 , 

, 133 , 2 , 173 , 

240 , 2 , 169 , 

144 , 34 , 240 , 

176 , 26 , 70 , 

74 , 160 , 06 , 

, 144 , 10 , 201 

74 , 170 , 24 , '7 

, 0 , 16 , 32 , 
00 , 120 , 160 , 
144 , 104 , 224 

, 200 , 240 , 32 

4 , 4 , 4 , 4 , 

^ r 


130 , 24 

133 , 3 

5 , 96 

103 , 40 

109 , 0 

16 , 200 
1 , 233 

6 , 163 

3 , 160 
10'7, 1 

, 200 , 

6 , 56 

64 

200 , 

r Or 

72 , 

4 


176 


U r 
U r 


U r 

7 7 


o 

7 


2 40 
112 


NLfiGRY/FvLGlOl LF< KLGlUIKLtfLN'l ^ 


roister* tha 


lhis rout i n* u=>-5 the: accumulator r this , X 
.y index red i step, and 2 hyt*s on the stack. 3 byUs qj , ._ t . r3dl5 on 
zero rase are required. 1routine takes ur 15,. . 

u t.' => L* ►j S 0 i III rl »« U 1 s * 


* 3 ^ 




-_- 3 >„ 




•7/13/02 


t o 1 V 1 ii) odor* 








APP NOTE 100'. 


COLLISION DETECTION 



lbO cycles (1 m i cr osecr.ds or. s 1.02 fihz system) 


Here is another ex3wpie which puts the collision detection 


outines together with the move routines and the clock routines. 



Three sprites ars displayed. On the top liner lel't to ridhtr 




sprite collisions are displayed on the left half of the second line. 



shown. On the right side of the second line the row and column 


sprite to background collision. 


JOUllCL LISTING 
1000 .PACE ’ADLC’ 

ion) ; 

1020 } 

1030 X-K00U2 
1040 r 

1030 ? VAilIAGL lS 

1040 oof! *=«n jorrccT high 

1 ,170 0SL — x !• 1 r0! : i*G£T LOW 



1000 TiOOli 


t ! 1 
:-l 
i 1 
< M 



rttODULUO HIGH 
;ilOOULUG LOW 
jTEflP .X 


% ! !J 

si 
: 1 
:• 1 


p * << i.-. 







APP NOTE 1004 


COLL 101 ON DE TEC I'I ON 


1160 
1170 
1100 
119 0 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1200 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1300 
1390 
1400 
1410 
1420 
1430 
1 440 
1450 
1460 
1470 
1400 
1490 
1300 
1510 
1320 
1530 
1540 
1550 
1560 
1570 
1500 
1590 
1600 
1610 


LF C 

•C • •% 

r» 

LJ 

; EVENT F NAME COUNTER 

i * P G 

V — 

• .% 

•1 

r I* R AMES * P LR • G L L 0 N 0 ( 1 • V • GlANOARO) 

Pi 00 

;/ — ;r 
•\ — 

1 

? MODULUS 

KLOilP 

V V 

- •< 

•1 

FRASIER LCMpArE VALUE 

OX 

y «■» •/ 

X — 

1 

^JOYSTICK X DIRECTION OfTCL1 

DY 

v •/ 

•s • •% 

•1 

t JOYSTICK Y OIRECriON OF FSE f 

ONUM 

y y 

.% — 

1 

;SPRITE NUMBER TO MOVE 

COUNT 

y — y . 
— A 

1 

}NUMBER Or VALID COLLISIONS 

PLAYER 

V. — y 
•*W — A 

•1 

?SPRITE TO CHECK ON (PLAYER SPRITE) 

PXMAX 

y — y 
.% — .% 

1 

JMAXI MUM SIZE Or PLAYER IN X DIRECTION 

PYilAX 

y, — *:*. 

•1 

?MAXIMUM SIZE OP PLAYER IN Y DIRECTION 

COL 1OE 

•% ■* *A 

1 

? TEMPORARY STORAGE FOR C0LL1C10N REGIS 

rx 

y — v* 

•C — .N 

•2 

} TEMPORARY SPRITE X POG STORAGE 

TY 

# v «. y 

1 

^TEMPORARY SPRITE Y POS STORACL 

PLX 

y — y . 
•% • 

: 2 

JPLAYER SPRUE X POSITION 

PLY 

y v. 

A* — A 

>• 1 

r PLAYER SPRITE Y POSITION 

TEMP 

y — y . 

A — A 

i 1 


RESULT 

y -• y 

a •• •% 

: 7 

FSPRIIE NUMBERS OP VALUE COLLISIONS 

f 

XC 

y — y i 

- .v i 

: 2 

',2 BYTE X COORDINATE Or SPRUE 

YC 

y v i 

••• - i 

M 

; Y COORDINATE OF SPRITE 


?CONGTANTS 


SCREEN 

SPRPTR 

SPRX 

SPRY 

MSIGX 

RASFIGii 

RAGfER 

GPENA 

YXPAND 

XXPAND 

GPRGPP 

0PROAK 

GCOLOR 

r 

xon 

yofp 

r 

. END 
• F’AGL 


■10400 
= 107F 0 
=10000 
■1D001 
=10010 
=10011 
=10012 
=10015 
= 10017 
"10010 
=100 IE 
■1001F 
= 10027 

= 0 
=3 


'EXAMPLE 7 


;SPRITE DATA POINTER 

; VIC 

REGISTER? 

GPRITE 

;VIC 

REGISTERJ 

SPRUE 

rVIC 

REGIS TER ? 

SPRITE 

?V1C 

REGISTER: 

RASTER 

r VIC 

REGISTER? 

RAS TER 

; vie 

REGISTER? 

SPRITE 

\ GPR 

ITE Y EXPAND 

?vic 

REGISIER? 

SPRITE 


X POSITION 
«0 Y POSITION 
i1C3 31 fG 


LG3' G 


enable 
X- expansion 


FSCREEN CENTERING CONST ANTE 


1620 


* = 13 

000 


163D 
164 0 

r 

EXAM 

SL1 


;DISABLE 1R0S 

1650 


lda 

1150 

; ASSUME PAL UNLESS F 

1660 


ST A 

f PS 

(PAL IS 50 FRAMLS 

1670 


LDX 

ttlOl 

fS£ T UP PAL MODULUS 

1600 


LOY 

HIf 0 

r SET UP PAL MODULUS 

1690 

EXO 

lda 

RASiiuH 

’ LOOK AT RASTER MS3 

1700 


BPL 

LXO 

Flf 0 TFILN RASTER < 

1710 

EX1 

LDA 

illOO 

r RAS1ER > 255 . . ,3U f 

9/15/0 

2 



C 0 fii iii 0 d O i" i 


r*ER- 

flG3 

ECO 

*3 If A 
*=•'^6. GO 


OTHERWISE 

OLD 


1 ? 
LOOK 


again 


-c .. 




pa^t' 2< 









APP NOTE 1004 


COLLISION DCfECTION 


1720 


CMP RASTER 

1730 


DCC EX2 

1740 


LDA RASHCH 

1750 


13MI CXI 

1760 


LDX ft*02 

1770 


LDY it*00 

1700 


LDA ft60 

17?0 


S IA FPS 

1000 

EX2 

SIX MODI! 

1010 


STY i'lODL 

1020 

r 


1050 


LDY ftO 

1040 


LDA SI 

1050 

EX02 

STA £DOOG t Y 

1060 


STA $DOQO :-256 r Y 

1070 


STA $-0000-: 512 r Y 

1000 


STA $DGOO :-760 r Y 

1090 


DEY 

1-700 


ONE CX02 

mo 

r 


1720 

; init 

1AL12E SPRITE VAl 

i/JU 

r 


i / ; !U 


LDA ft i7f 

1-750 


STA SPRY 

1960 


STA SPRX-: 2 

1970 


r 

1900 


LDA H50 

1990 


OTA SPRX 

2000 


STA SPRY:2 

2010 

r 


2020 


LDA ftlDO 

2030 


STA SPRX:-4 

2040 


SI A SPRY :4 

2050 

r 


2060 


LDX ft2 

2070 

XAG 

LDA tHOO 

2000 


STA GMSlirX 

2090 


1XA 

2100 


STA SCOLOR,X 

2110 


DEX 

2120 


GPL XAG 

2130 

T 


214 0 


SI A MS1GX 

2150 


STA SNUM 


n 

YES 


r IS 
: IF 

f IF NO 
•Li- YC3 
’SET UP 
: Gil T UP 

;sei up 

(NTSC 


264 ? 

f!ll£N SRANCH. TO STD ■* PAL !! 


THEN CHLCK F OR 
THEN GOTO CXI 
NTSC MODULUS t 
NTSC MODULUS L 
NTSC 
IS 


MOD Of RACIER*1 
SO. TO STD * NTSC 


PER- SLCOND 
:s PER SLCOND) 
SIORE IN MODULUS FOR FUTURE USL 


60 FR Ai1£ 


?COLOR SCREEN Willi L 
?UNITE 


2160 r 
2170 
2100 
217 0 
2200 
2210 r 
2220 
2200 
224 0 
2250 
2260 r 
2270 

9 / 15/02 


LDA HiOG 
STA 3PRPTR 
STA SPRNR-sl 
5 T A 5PRP r K !-2 

LDA ft7 
STA XXPANO 
SI A YXPAND 
SI A SPLNA 

LDX ft62 


?SET SOME SPRUES 10 127 


?SLT OTHERS 10 50 


;SI 1LL OTHERS 10 100 


? CLEAR OUT SMSDS & MC1GX 
!S SLI SPRlIL. COLOKU 


;START MOVING SPRITE ttO 
r SET POINTERS 10 SPRITE PICTURE 

?LNADLL AND EXPAND SPRITES it 

u U ' 1 r 

r SET SPRUE 

L o iii iii odor* 


•■*3 a® 2s 

vJ 






AFT NOTE 1004 


COLLISION DETECTION 


2200 
2290 
2300 
2310 
2320 
2330 
234 0 
2350 
2360 
2370 
2300 
2390 
2400 
2410 
2 420 
2430 
2 440 
2450 
2460 
2470 
2400 
2490 
2500 
2510 
2520 
2530 
2540 
2550 
2560 
2570 
2500 
2590 
2600 
2610 
2620 
2630 
264 0 
2650 
2660 
2670 
2600 
2670 
2700 
2710 
2720 
2730 
274 0 
2750 
2760 
27 70 
2700 
2 770 
2000 
2010 
2020 
2030 

9 / 15/0 


EX 3 


LX 4 - 


WEX 



OAG 


LDA 00 AT A r X 
G’f A 42000 rX 

DLX 

Si PL 0 X 3 

LDA 84 4 
OTA PXilAX 
LDA 830 ' 

OTA PYilAX 

JOR UTAMX 
LDA H 4 FA 
OTA FvCOflf 

JSFC D JF\‘F\ 

DCS EX 5 

LDA SNUM 
LOP 8401 
OTA SNUtt 
JSR D JRR 
DCC WEX 
DCS LX 4 

LDA SNUfl 
LDX DX 
JSR UNIMUX 
JSP A rvfix 
LDA CNUM 
LDY DY 
JCR f'lVOY 


F NOT E ?• WHEN SPRITE POINT ER= 120 
FOPfxlTE ADDRESS -42000 

F SET SPRITE 012 L FOR COLLISION DLTECUON 


FlRANCF CR NC 1 GX 0110 10 Of;CD DY 1 L 0 
F SET PAG TCP COMPARE TO JUO r OFF 
FlFiL DOT TOM or VISIDLL VIEWING AREA 

FREAD 1 ML J 0 YC 1 ICK 

Fli- C ~0 THEN FIRE SUTTON PUSHED CHANGE OPP 
FNOW DO 01 HER MOVING SPRITE 


FWA 1 T UNI IL DU 110 N 1 C NO LONGER F’RCSGED 


FLOAD .A WITH SPRITE NO. 

FLOAD .X WITH JOYSTICK X -DIRECTION (V-FS^r 
FKOVE SPRITE MODULO ( 504 - PAL OR 510 . \>rcr\ 
F TPANOFEP SilSS 3 YTE 0 TO ( 10 I 0 X SITS*" ' 
FLOAD .A WITH SPRITE NO. 

FLOAD .Y WITH JOYSTICK Y -DIRECTION tv.-ov-r 
F MOVE 1 FiL OPR I'l E IN Y DIRECTION 


OUTPUT OPRIIE COORDC 8 , C 0 LL 1 C 10 N CTA 1 UC 10 SCREEN 


LDX 82 
LDY 85 

LDA CNCDrX 
JSP 3 TH 
TXA 
ASL A 
TAX 

LDA OPRXrX 
JSP 3 TH 

LDA OF'RY 7 X 

I NY 

1 NY 

JSR 3 TH 
I NY 
I NY 
1 NY 

I XA 
Lop a 


;CENTER TF!E OUTPUT LINE 

F CONVERT SPRITE X COORDINATE 10 A>-fn «r Y 
F CCNVER T 3 INARY TO SCREEN ASC ? “ huX 

FMUL 1 DY 2 FOR A SECOND 

;DO FOR X LCD'S... 

F . ..AND Y 

;GKIP A SPACE SETWEEN X AND Y COORDS 
fSICIP DEI WEEN SPRITES 


FNOW SCI IT DACK 


C O hi «ii O •j O i »£i 


p 3 3 £ 







APR NOTE 1004 


COLL 13 ION DETECTION 


204 0 


TAX 


2050 

r 



2060 


DLX 


2070 


URL OAO 


2000 

7 



2090 
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, 1, 160 

, 169, 0 

, 17, 200 

169, 60 

160, 0 
0 , 21 / 
136, 200 

141, 1, 200, 141, 2 

HI, 0, 200, HI, 3 

141, 4, 200, 141, 5 


153, 0, 216, 153, 

210 , 

12 /, 

50, 

100 , 


200 , 

32, 

7, 

200 , 

62, 

16, 

133, 

29, 


169, 

202 , 

169, 

141, 

Hi, 

109, 

247, 

36, 


0, 149, 

16, 24 

120 , 

250, 

23, 

214, 
169, 

32, 

171, 


0, 130 

245, 141, 16 

141, 240, 7 

/, 169, 7 

200, 141, 21 
50, 15/, 0 

44, 133, 35 

130, 49, 169 

49, 176, 13 


165, 

32, 

73, 

1, 133, 32 

r 52, 171 


49, 

144, 

251, 

176, 230, 

165, 32, 

166 

30, 

32, 

50, 

49, 32, 126 

, 49, 165 


32, 

164, 

31, 

32, 152, 49, 162, 2 


160, 

5, 

101, 

0, 32, 17, 

49, 130 


10, 

170, 

109, 

0, 200, 3 

2, 17, 49 


109, 

1, 

200, 

200, 200, 

52, 17, 49 


200, 

200 

, 200 

, 13 0, 74, 

170, 202, 

16 

225, 

32, 

200, 

49, 162, 

39, 169, 3 

•y 

157, 

40, 

4 , 

202, 16, 250, 166, 32 


32, 

6, 

50, 1 

66, 33, 240 

, 12, 160 


42, 

101, 

44, 

32, 17, 49 

, 200, 200 


202, 

200 

, 2 46 

, 164, 32, 

32, 145, 

50 

176, 

145 

, 152 

, 160, 72, 

32, 17, 4 

9 

200, 

200 

, 130 

, 32, 17, 

49, 76, 14 

7 

40, 

72, 

41, 

15, 32, 40, 

49, 153 


1, 

4, 104, 74, 74, 74, 

74, 32 


40, 

49, 

153, 

0, 4, 200, 

200, 96 


201, 

10, 

144, 

3, 233, 9 

, 96, 9 


40, 

96, 

1 fAr 

6 , 15 4 , 5 , 

170, 10 


160, 

169 

r Or 

135, 2, 24 

, 165, 5 


16, 

20, 

73 r 

255, 105, 1 

, 155, 5 


56, 

165, 

5 r 

229, 5, 135 

, 5 , 1 o j 


4 , 

229, 

2, 1 

33, 2, 24, 

105, 0 


200, 

101 

r Jr 

155, 0, 200, 101, 0 


101, 

2, 

KVr 

Ur b6r 1 Cl u 

, 0, 200 


>29, 

U r 

iJJr 

/ t 1 01 r Or 

229, 4 


144, 

7 r 

1 <Vr 

Or 1 6b r 7 r 

153, 0 
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COLLISION DETECTION 


DATA 
DATA 
DATA 
DAT A 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DAT A 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DAT A 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DAT A 
DATA 
DAT A 
DA TA 
DATA 
DATA 
DAT A 


200 r 

152, 

74, 

166 

, 6, 

96, 

162, 

7 

101, 

0, 

74, 

46, 

16, 2 

00, 

202, 

16 

247, 

96, 

162, 

7, 

173, 

16, 

200, 

06 

Or 

10, 5 

4, 0 

, 20 

2, 16 

, 240, 9 

6 

10, 

170, 

152, 

125 

, 1, 

200, 

157 

, 1 

200, 

201 , 

29, 

144 

, 5, 

169, 

24 9 

, 221 

1 r 

200, 

96, 

172, 

0, 2 

20, 

160, 

0 

162, 

0, 

74 , 

176, 

1 , 1 

ti(j 7 

74, 

176 

1, 

200, 

74, 

176, 

1, 202, 

74, 

176 

1, 

222, 

74, 

134 , 

30, 

132, 

31, 

96 

22, 

247, 

49, 

162, 

7, 

246, 

19, 

202 

16, 

251, 

165, 

27, 

133, 

20, 

166 

, 16 

22, 

2 29, 

49, 

134, 

16, 

200, 

15, 

169 

60, 

122, 

20, 

166, 

1C, 

32, 

239, 

49 

124, 

10, 

200, 

2, 

230, 

17, 

96, 

232 

220, 

20, 

144, 

2, 

162, 

0, 

96, 

173 

10, 

200, 

197, 

29, 

2 40, 

249 

, 173, 10 

200, 

197, 

29, 

200 

, 249 

, 96 

, 169, 0 

122, 

22, 

172, 

30, 

200, 

133 

, 37 

, 13 4 

34 , 

109, 

135, 

50, 

37, 

7 r 

240, 

04 

22, 

109, 

50, 

133, 

41, 

165, 

39, 

133 

42, 

165, 

40, 

133, 

43, 

162, 

7, 

220 

24, 

2 40, 

62, 

109, 

135, 

50, 

37, 

37 

240, 

55, 

22, 

109, 

50, 

56, 

229, 

41 

160, 

165, 

29, 

229 

, 42, 

176 

, 14 

, 133 

44 , 

152, 

/ 6 7 

255, 

105, 

1, 

160, 

165 

44, 

72, 

255, 

105, 

0, 

200, 

26, 

152 

197, 

25, 

176, 

21, 

56, 

165, 

40, 

229 

42, 

176, 

4, 

73, 

255, 

105, 

1, 

19 7 

26, 

176, 

6, 

230, 

23, 

164, 

23 r 

150 

44, 

202, 

16, 

107, 

96, 

130, 

10, 

160 

105, 

1, 

200, 

133, 

40, 

173, 

16, 

200 

61, 

125, 

50, 

240, 

2, 

1.69, 

1, 

133 

29, 

105, 

0, 

200, 

132, 

30, 

96, 

1 

2, 

4, 0, 

16, 

32, 

64, 

120, 

173 


21 , 

200, 

57, 

135, 

50, 

240, 

61 , 

152 

10, 

170, 

56, 

109, 

0, 

200, 

233, 

2 4 

122, 

52, 

1 / 2, 

16, 

200, 

57, 

135 

, 50 

2 40, 

2, 

169, 

1, 

232, 

Or 1 3 •£ 7 

53 

144 , 

24 , 

240, 

6, 

165, 

52, 

201 , 

06 

176, 

26, 

70, 

52, 

165, 

52> 

106, 

74 

74 , 

160, 

56, 

109, 

1, 

200, 

223, 

53 

144, 

10, 

201, 

200 

, 176 

, 6, 

7 4, 

74 

74 , 

170, 

24 , 

96, 

56, 

96, 

0, 56 

0, 

0, 92 

, 0, 

0, 

150, 

0, 

1 


21, 

0, 2 

, 21 

, 12 

0, 4' 

(j -U 7 

192 


0, 

222, 

224, 

19, 

31, 

240» 

4 4, 

31 

24 0, 

112, 

31, 

252 

, 96, 

r 

252 

' 4 0 

21, 

2 40, 

12, 

31, 

224, 

J 7 

J 1 r 

120 

0, 

222, 

0, 0 

, 56 

, o , 

Or 

0 


0, 

u, 0, 

0, 

0, 

0 , o, 

0 



0, 

o, o. 

0, 

0 
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App Note 1005.3 


Multiple Sprite Interrupt Routine 



SOI 


"TyAR rz 


A F* F* l_ X C A riON 


NOTE 1005 .3 


Authors ? Eric Cotton and Andy Finkel 


S ut fc*. »=- c -fc. 5 Raster Scan - Multiple Sprite Interrupt Routine 


T > 2 : l >2 v i -s i o n: S ta-iTd 3 i"-d ~ NTSC and PAL 


X - ABSTRACT* - The purpose of this application note is to 
supply a Method -for displaying up to 16 sprites on the screen 
siwultaneously- When a prosraw- uses one to eisht sprites at a timer 
the VIC IT sprite registers 3re usually updated once per frame while 
the raster is not scanning the visible viewins area. If, however, 
immediately a-fter a sprite is drawn on the screen we chanse its 
position to a location follow ins the raster, the sprite will he 
drawn once asain 3t the new location. For example, suppose we 
position a sprite on the screen at x=200, y=70. If, after the raster 
moves P3st the bottom of the sprite, we chanse the y coordinate to 
150 the raster will draw the sprite asa in at :<=200, y = 150, (= or 3 
bri* - ? instant the sprite will be displayed on two parts of the 
ccreen siMultaneously. By apply ins this technique to the other 
sprites we -find that we can display 16 spr i tes (or more, j p 
repeat the process) at a time. 


we 


exposition; 

-*■ 1*902 Commodore 

(c) 


The IRQ 


serv routine (IRQSVC) 

pase 1 





App Not* 1005.3 


Multiple Sprit* Interrupt Routine 


presented in this application not* allows the user to display 16 
sprites on the screen at a t i we (under- prosram control). Instead of 
writins sprite information directly to the VIC,the- user should write 
to two pseudo VIC chips located on zero pas*. Each pseudo chip 
controls eisht sprites (setl and set2>. Set 1 sprites should be 
limited to y positions in the top half of the screen and set 2 
sprites should be l i a i ted to y positions in the .bottom half. Each 
set is alternately transfered to the real VIC chip by the IRQ 
rout i n*-. 

Interrupts are senerated when the raster is at the middle of 
the screen (r3ster=^-98) and when- it is Just ?3st the visible viewing 
area (raster=*FA) .. The first' transfers data frost the bottom eisht 
sprites- (set 2) to - the- VIC chi Pr while- the second transfers the data 
from- the top eisht. (set. I)- 

Included is a set-ue routine which:' (1) disables interrupts 
from the- 6526 CI-A, (2) loads the IRQ vector 3t “50314--S0315 w.ith the 
address of the new routine, (3) disables all VIC II interrupts 
except for rastei—comparer and (4) sets the first interrupt -for 
raster line $FA. 


(c) 1982 Commodore 
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A. Pseudo VIC Chip 
address, name* set , and 
applicable) for each 
he* a dec i wa l 


Resister Hap? The. follow ins map shows the 
correspondins VIC II chip location (where- 
pseudo reSister, All numbers are in 


A00R 

MARE 

SET 

VIC 

03 

S1XLS8+0 

1 

00 

04 

SlXLSB-t-1 

1 

02 

05 

S1XLS8+2 

1 

04 

06 

S1XLS3+3 

1 

06 

07 

S1XLSB+4 

1 

08 

08 

S1XLS8+5 

1 

0A 

09 

S1XLSS+4 

1 

OC- 

0A 

S1XLSB+7 

1 

0E 

03 

S2XLSB+Q 

2 

00 

OC 

S2XLS8+1 

9 

02 

0D 

S2XLSB-+2 

2 

04- 

0E 

S2XLSB-K5 

2 

06 

OF 

S2XLSB+4- 

2 

08 

10 

S2XLS8+5 

2 

0A 

11 

S2XLS8-+4 

2 

OC. 

12 

S2XLS8-t-7 

2 

0E 

13 

S1XRS3 

1. 

to 

14 

S2XRSB 

2 

10 

15 

S1SPRY+Q 

1- 

o.t 

16 

S1SPRY+1 

1 

03 

17 

S1SPRY+2 

1 

05 

18 

S1SPRY+3 

1 

07' 

19 

S1SPRY+4 

1 

09 

1A 

S1SPRY+5 

1 

03 

IB 

S1SPRY+6 

1 

00 

1C 

S1SPRY+7 

1 

OF 

ID 

• S2SPRY+0 

2 

01 

IE 

S2SPRY+1 

2 

01 

IF 

S2SPRY+2 

2 

01 

20 

S2SPRY+3 

2 

01 

21 

S2SPR Y-t-4 

2 

01 

22 

S2SPRY+5 

2 

01 

23 

S2SPRY+6 

2 

01 

24 

S2SPRY+7 

2 

01 

25 

26 

27 

23 

(c ) 

S1SPTR+0 

1 

— 

SISPTR+l 

1 

- 11 '" 

S1SPTR+2 

1 

— 

S13PTR-+-3 1 

\ 982 CoftWiiodor* 



ADDR 

NARE 

SET 

VIC 

29 

S2SPTR-K 

1 

- 

2A 

S2SPTR+5 

1 

— 

28 

S28PTR-t-6 

1 


2C 

31SPTR+7 

1. 

— 

2D 

S2SPTR+0 

2 

- - - 

2E 

S2SPTR+1 

2 

— 

2F 

S2SPTR-C2 

2 

— 

30 

S23PTR+3 

2 

— 

31 

S2SPTR-:~4- 

2 

— 

32 

S2SPTR-H5 

2 

— 

33 

52SPTR+6 

2 

— 

34 

S2SPTR+-7 

2 

— 

35. 

S1C0LR+0 

1 

27 

36 

S1C0LR+1 

L 

23 

37 

S1C0LR+2 

1 

29 

38 

S1C0LR+3 

1 • 

2A 

39 

S1C0LR+4- 

L 

23 

3A 

S1C0LR+5 

1 

2C 

33 

S1C0LR+6 

1 

20 

3C 

S1C0LR+7 

1 

2E 

3D 

S2C01R-K) 

2 

27 

3E 

S2C0LR+1 

2 

23 

3F 

S2C0LR-K2 

2 

29 

40 

S2C0LR-+3 

9 

2A 

41 

S2C0LR+-4 

2 

28 

42 

S2C0LR+5 

2 

2C 

43 

S2C0LR-I-6 

o 

20 

44 

S2C0LR+7 

2 

2E 

45 

S1XPRO 

1 

ID 

ID 

46 

32XPND 

2 

47 

S1YPND 

1 

17 

17 

48 

32YPND 

o 

w 

49 

S1SC0L 

1 

2 

1 

IE 

IE 

4A 

4e 

32GC0L 

S1SDCL 

4C 

S2SDCL 

2 

18 

13 


P3Se 3 
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B. Prosrsm List mss? 
1. Sour-ca! 


1000 

1010 

1020 

1030 

1040 

1050 

1060 

1070 

1080 

1090 

1100 

1110 

1120 

1130 

1140 

1150 

1160 

1170 

1190 

1190 

1200 

1210 

1220 

1230 

1240 

1250 

1260 

1270 

1280 

1290 

1300 

1310 

1320 

1330 

1340 

1350 

1360 

1370 

1380 

1390 

1400 

1410 

1420 

1430 

1440 

1450 

1460 


.PAGE 'IRQSVC ' 

JIRQSVC! THE IRQSVC ROUTINE ENABLES THE USE 
;OF 16 SPRITES DIVIDED INTO TWO SETS.. SET1 
JIS LIMITED TO POSITIONS ON THE TOP HALF OF 
?TH£ VISIBLE. VIEWING AREA, SETZ IS LIMITED 
JTO THE BOTTOM HALF.. THE SET UP ROUTINE 
;(SETUP) SHOULD BE EXECUTED ONCE AT THE START 


*=$02 
VARIABLES 
HOLDX *=*+1 


!0R ELSEWHERE ON ZERO PAGE 
!TEMPORARY STORAGE FOR X REGISTER 


SHADOW VIC II CHIP REGISTERS 


S1SPRX 

S2SPRX 

•*=•*+3 

*=*+8 

;x LSB / SET1 
;-X LSB / SET2 

S1XMSB 

S2XMSB 

*=*+1 

?X MSB / SETI 
;X MSB / GETZ 

SI SPRY 
S2SPRY 

*=*+8 

*=**8 

rY POS / SETI 
; Y- POS. / SET2 

S1SPTR 

S2SPTR 

X-=*+0 
* -=*+8 

;SPR POINTERS / SETI 
;SPR POINTERS / SET2 

S1.C0LR 

S2C0LR 

*=*+8 
-*=* H - 8 

;SPR COLORS. / SETI 
?3PR COLORS / SET2 

S1XPND 

S2XPND 

*=*-(-1 

*=•*+1 

• r X EXPAND / SETI 
;X EXPAND / SET2 

S1YPND 

S2YPND 

*=*-♦-1 

*=*+1 

; Y EXPAND / SETI 
?Y EXPAND / SET2 

S1SC0L 

S2SC0L 

*=*+1 
•••* =*-+1 

; SPR - SPR COLLISIONS 

jspr-spr collisions . 

t 

S1SDCL 

S230CL 

*=*+1 

*= Hf+l 

;SPR-OATA COLLISIONS 
; SPR - OAT A COLLISIONS 


SET 1 
SET2 


/ 

/ 


SET 1 
3ET2 


;CONSTANTS 
SPOPTR =*07F8 
CIACRA =$0C0£ 

; V I C II CHIP REGISTERS 


;SPR DATA 
;• TIMER A< 


POINTERS 

CONTROL REGISTER 


1470 

SPOX 

=•50000 

1480 

SPOY 

=$0001 

1490 

MSIGX 

=50010 

1500 

r.\ ; -: • 

- ; r ; ' ; ? 

1510 

3 PEN A 

=50015 

1520 

YXPAND 

=50017 


;SPRO X POSITION 
;SPRO Y POSITION 
;SPR X POSITION 
JRASTER LSB 
’SPR ENABLE REG 


LSB 

MSB'S 


uriHOLc REGISTER 
Y EXPANSION 


(c> 1982 Co-M.rtodor -2 
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1530 

1540 

1550 

1560 

1570 

1580 

1590 

1600 

1610 

1620 

1630 

1640 

1650 


VICIRQ 

IRQMSK 

SPOACL 

XXPAND 

SPRCOL 

SPOCOL 


=■50019 
=.t001 A 
=*0018 
=*0010 
=5001E 
=*0027 


CIACRA- =50C0£ 


*=*COOO 


;VIC IRQ REGISTER 
JVIC IRQ ENABLE ENABLE 
JSPR—DATA COLLISION REGISTER 
r SPR X EXPANSION 
?SPR-SPR COLLISION REGISTER 
}SPRO COLOR 

; TIMER A CONTROL REGISTER 


}EXAMPLE ASSEMBLE VALUE 


J* IRQSVC SETUP x 
1670 ; 


1680 

SETUP 

SEI 


/.DISABLE IRQ'S WHILE SETTING UP 

1690 


LDA 

K500 

}DISABLE 6526 INTERRUPTS 

1700 


STA 

CIACRA 


1710 


LDA 

tKIRQSVC 

?CHANGE IRQ VECTOR TO NEW 

1720 


STA 

50314- 

; IRQ ROUTINE 

1730 


LDA 

fr>IRQSVC 


1740 


STA 

50314H-1' 


1750 


LDA 

tt$FA- 

?S£T FIRST INTERRUPT FOR RASTER *FA 

1760 


STA 

RASTER 


1770 


LDA 

tt*01 

r MASK OUT ALL BUT RASTER INTERRUPTS 

1780 


STA 

IRQMSK 


1790 


LDA 

»$FF 

;ENABLE ALL SPRITES 

1300 


STA 

SPENA- 


181.0 


CLI 


?RE-ENABLE IRQ r S 

1820 

r 




1830 

SETUPO 

JMP 

SETUPO 

;G0 INTO AN ENDLESS LOOP 

1340 

r* 




1850 

r 





1360 
1870 
138.0 
1890 
1900 
1910 
1920 
1930 
1940 
1950 
1960 
1970 
1990 
1990 
2000 
2010 
2020 
2030 
2040 
2050 
2060 
2070 
2080 
2090 
2100 
(c) 


;* IRQSVC ’ INTERRUPT SERVICE * 
\* FOR MULTIPLE SPRITES * 


IRQSVC 


CLD 

LDA 

BPL 

STA 

LDX 

LDY 

LDA 

CMP 

BNE 


VICIRQ 

EXIT 

VICIRQ 

tt*OF 

K501 

H*FA 

RASTER 

IRQO 


JMAKE SURE DECIMAL MODE IS 
;CLEAR CURRENT INTERRUPT... 

;...BUT MAKE SURE THE VIC CAUSED 


NOT SET 
IT 


SET2 IS TO BE SET UP, 
PREPARING INDEXES) 

*FA 


ASSUME 
(BY 

...UNLESS RASTER 
(IN.WHICH CASE DO NOT 
...AND SET UP SET 1) 


P 


vANCH. 


',*** SET UP SET 1 HALF 


RASTOP 


IRQO 


LDX 

DEY 

LDA 


fi*07 


H *98 


STA 

STX HOLDX 

1982 Commodore 


OF SCREEN *** 

;PREPARE INDEXES TO SET1 

;NEXT INTERRUPT AT RASTER = * 9e 


• latch for next raster interrupt 

;ST ORE .X FOR LATER USE F 


p 3$e 


_- • 
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2110 

r 





2120 


LDA 

S1XMSB r Y 

;TRANSFER SHADOW... 


2130 


STA- 

MSIGX 

r . ..X POSITION MSB'S 


2140 


LDA 

ClYPMDrY 



2150 


STA 

YXPAND 

}...Y EXPANSION 


2160 


LDA 

S1XPND i Y 



2170 


STA 

XXPAND 

?...X EXPANSION 


2180 

r 





2190 


LDA 

SPRCOL 

;STORE SPR-SPR COLLISION 

REGISTER 

2200 


STA- 

S1SC0L/Y 



2210 


LDA 

SPDACL 

;and spr-oata collision 

REGISTER 

2220 


STA 

S1SDCL r Y 



2230 

r 





2240 


LDY 

H*OE 

; TRANSFER SHAOOW. ... 


2250 

IRQl 

LDA 

SlSPRXrX 



2260 


STA 

SPOX / Y 

J...X POSITION LSB'S 


2270 


LDA 

S1SPRY > X 



2280 


STA 

SPOY,Y 

Y POSITION 


2290 


DEX 




2300 


DEY 




2310 


DEY 




2320 


BPL. 

IRQl 



2330 

7 





2340 


LDX 

HOLDX 



2350 


LDY 

fHQ7 

f TRANSFER SHAOOW... 


2360 

IRQ2 

LDA 

S1C0LR t X 

- 


2370 


STA 

SPOCOLrY 

r... .SPRITE COLORS 


2380 


LDA 

SISPTRrX 



2390 


STA- 

SPOPTR,Y 

r... SPRITE POINTERS 


2400 


DEX 




2410 


DEY 




2420 


BPL 

IRQ2 



2-430 

r 





2440 

r 





2450 

EXIT 

PLA 


^RESTORE REGISTERS 


2460 


TAY 




2470 


PLA 




2-430 


TAX 




2490 


PLA 




2500 


RTI 




2510 

r 





2520 

. END 
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2. Hex dump- (3-s assembled at $C0QQ>; 

. J 2000 78 A9 00 00 OE DC A? 23 30 14 03 A? CO 00 15 03 

. : 2010 A9 FA QD 12 DO A9 01 80 1A DO A9 FF 80 15 00 58 

.J 2020 4C 20 CO 00 AO 19 DO LO 59 00 19 00 A2 OF AO 01 

. : 2030 A9 FA CO 12 DO 00 05 A2 07 88 A9 98 80 12 DO 86 

.: 2040 02 B9 13 00 80 10 DO 39 47 00 00 17 00 39 45 00 

.! 2050 80 ID DO AO IE DO 99 49 00 AO IB DO 99 43 00 AO 

. : 2060 OE 35 03 99 00= DO 35 15 99 01 DO CA- 80 88 10 FI 

2070 A6 02 AO 07 35 35 99 27 00 35 25 99 F8 07 CA 88 

.: 2080 10 F2 68 A8 68 AA 68 40 


1000 

1010 

1020 

1030 

1040 

1050 

1060 

1070 

1080 


3. Data statements (as assembled at SCOOQ): 

data 120,169,0,1.41,14,220,1.69,35,141,20,3,169,192,141,21,3 
data 169 ,-250,141,18,208,169,1,141,26,208,169,255,141,21,200,88 
data 76,32,192,216,173,25,208,16,09,141,25,200,162,15,160,1 
data 169,250,-205,18,208,208,5,162,7,136,169,152,141,18,208,134 
data- 2,185:, 19,0,141,16,203,135,71,0,141,23,203,135,69,0 
data 141,29,208 r-173,30,208,153 r-73. Or 173,27,208,153,75,0,160 

data 14,181,3,153,0,208,181,21,153,1,203,202,136,138,16,241 
data 166,2.,. 160,7,181,53,153,39,208,181,37,153,248,7,202,136 
data 18,242,104,168,104,170,104,64 


C. Memory/ReSister Resu i rements?' The set up- routine (SETUP) 
res u i res 32 ($20) bytes of memory (excluding the endless loop on 
line 1830) and uses the accumulator.. The interrup-t service routine, 
IRQSVC, resuires 101 ($65) bytes and uses the accumulator, 3nd the :< 
and y resisters.. Also, 75 ($6b) bytes of zero psse must be reserved 
for variables. 


D. Worst case execution time is 40 cycles (39.08 micro-seconds 
atl.02 (1Hz) for SETUP (excluding- line 1330) and 530 cycles (517.01 
mi cr-o-seconds )for IRQSVC.. 

E. User Notes- 

1. Our ins each i nterrurt the spr i te-to-sp r i te = n( .- 

i te-to-data collision resisters are stored for use in a coUj. 3 j on 

rout i ne. 

2. Whenever any or all of a spri te from one <r^ + 


(O 


1932 Commodore 


pase 7 
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positioned in the part of the screen reserved for the other, 
problems may develop. At best only flickering will occur, but at 
worst sprites may be split or color and sprite data may chanse in 
the middle. Sprites expanded in y have limited mobility because of 3 
Sreater likelihood of cress i nd' boundr i es.. 

3. IRQSVC does not push any of the resisters onto the stack 
upon interrupt. If executed on a Commodore 64, this is done by th* 
KERNAL (assuming lines 1710-1740 are left intact). The RAX Machine 
(or a Commodore 64 which emulates a RAX), however, does not have a 
KERNAL. Therefore, the contents of locations $FFFE and tFFFF should 
contain the address of IRQSUC- (low byte, hish byte order) ., Further, 
at the start of the IRQ routine should be the follow ins code to push 
the re-sisters onto the stack? 

PHA 

TXA 

PHA 

TYA 

PHA 


F. Example? The following example enables 3 i :<t.--=. n 

-_n sprites 3 nd 

Moves them around the screen in the x direction. Sample + , 

u t* data 

has been provided on the devlop-ment disk unde-r 


the 


name 


'numbers.bin'. The data should be loaded from UICRON (XVR 4 8) 


1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
(c) 1 


.PAGE 'IRQ3VC EXAMPLE' 


'THIS EXAMPLE OF THE ^QSVt: ENABLES 

?16 SPRITES AN0 MOOES THEM ABOUND THE SCREEN 


' 4. u onu ico mxu riv * - - _ _ 1 u r. 1 - „ _ ~ 

rlH THE X DIRECTION. FOR -AMPLE viFRITE DATA, 
• 1 i\ * n . a r. v rri r CALLED NUMBERS . SIN ’ 


?LOAO THE BINARY FILE CALLED 
'WITH VICM 0 N 


* = *02 

?32 Commodore 


'OR ELSEWHERE ON ZERO p 


AGE 


P33« 3 
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1090 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1330 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 
1630 
1660 
1650 
1660 
:c> 1 9 


; VARIABLES 
HOLDX *=*+1 


r TEMPORARY STORAGE FOR X REGISTER 


SHADOW VIC II CHIP REGISTERS 


ff-JH*8 

K-=4C—f-Q 

;X LS3 / SETL 
;x LSB / SET2 

k-=k-4-1 

*=*+1. 

•rX MSB / SET1 
$X MSS / SET2 

if = if4-0 
•if =*+8 

? Y POS / SET1 
r-Y POS / SET2 

* * 

II II 

rt 

CD CD 

r SPR POINTERS / SET1 
;SPR POINTERS / SET2 

if=if+G 
•if =-if+0 

r SPR COLORS / SET1 
rSPR COLORS / SET2 

if —tf-fl 
if = if+l 

?X EXPAND / SET! 

;X EXPAND / SET2 

if = if-hl 
•£=•*-+1 

;y EXPAND / SET1 

FY EXPAND / SET2 

if — if 4- 1 

* =ff+t 

?SPR-SPR COLLISIONS / SET1 
?SPR-SPR COLLISIONS / SET2 

if = if-hl 
•if=ff+l 

rSPR-OATA COLLISIONS / SET1 
r SPR—DATA COLLISIONS / SET2 


;CONSTANTS 
SPOPTR =$07F8 
CIACRA- =$OCOE 


rSPR DATA- POINTERS 
r TIMER A- CONTROL REGISTER 


JVIC II 

SPOX 

SPOY 

msigx = 

RASTER = 
SPENA = 
YXPAND * 
VICIRQ = 
IRQMSK * 
SPOACL * 
XXPAND 1 
SPRCOL = 
SPOCOL = 
CIACRA = 


*=$C000 


CHIP REGISTERS 
••$0000 ; 

$0001 ; 

'•$0010 ; 

$0012 ; 

:$0015 ; 

; $0Q17 

<$0019 ; 

$001A 

■$0013 ; 

: $001D 

: $001E i 

$0027 

:$0C0E I 


SPRO X POSITION LS3 

SPRO Y POSITION 

3PR X POSITION MSB'S 

RASTER LSB 

3PR ENA3LE REGISTER 

SPR Y EXPANSION 

VIC IRQ REGISTER 

VIC IRQ ENABLE ENABLE 

SPR-OATA COLLISION REGISTER 

SPR X EXPANSION 

SPR-SPR COLLISION REGISTER 

SPRO COLOR 

TIMER A CONTROL REGISTER 


J EXAMPLE ASSEMBLE VALUE 


.'• 4 ' IRQSVC SETUP » 
x . **** -hh*-**-**-*** a-****-*- 

qo Co«ftiodor* 


P33* 
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1670 

EXAM 

SEI 


^DISABLE IRQ'S WHILE SETTING UP 

1680 


LDA 

..#$00 

; DISABLE 6526 INTERRUPTS 

1690 


STA 

CIACRA 


1700 


LDA 

fKIRQSVC 

;CHANGE IRQ VECTOR TO NEW 

1710 


STA 

$0314- 

; IRQ ROUTINE 

1720 


LDA 

H>IRQSVC 


173G 


STA 

$0314+1 


1740 


LDA 

#$FA 

JSET FIRST INTERRUPT FOR RASTER $FA 

1750 


STA 

RASTER 


1760 


LDA 

ft $01. 

/MASK OUT ALL BUT RASTER INTERRUPTS 

1770 


STA 

IRQMSK 


1780 


LDA 

H$FF' 

;ENABLE ALL SPRITES 

1790 


STA 

SPENA- 


1800 

7 




1810 


LDY 

if 69 

JLOAD TWO SETS OF SPRITE DATA INTO 

1820 

EXAMO 

LDA 

VICDAT/Y 

r SHAOOW VIC DATA VARIABLES 

1830 


STA 

S1SPRX/Y 


1840 


DEY 



1850 


BPL 

EXAMO 


1860 

r 




1870 


CLI 


’/RE-ENABLE INTERRUPTS 

1880 

r 




1890 

EXAMl 

LDX 

#$0F 

;MOVE EACH SPR RIGHT 1 POSITION 

1900 

EXAM2 

INC 

S1SPRX/X 


1910 


DEX 



1920 


BPL 

EX A M2 


1930 

7 




1940 


LDX 

#$0F 


1950 

EXAM3 

LDY 

tt$FF 

/A- DELAY LOOP 

1960 

EXAM4 

DEY 


* 

1970 


BNE 

EX AM 4- 


1980 


DEX 



1990 


BNE 

EXAM'3 


2000 

r 




2010 


JMP 

EXAMl 


2020 

r 




2030 

* 

r 




2040 

;***** 


?********-** 

******i^.b* 


?050 ;* IRQSVC? INTERRUPT SERVICE » 
2060 J* FOR MULTIPLE SPRITES * 

OQJQ ■ A X X - M - K '- i KHHe-frifrfrfri 


2080 f 
2090 IRQ3VC 
2100 CLD 

-?! in LDA VIC IRQ 

2120 BPL EXIT 

2130 STA VICIRQ 

2140 LDX rt^OF 

2150 LDY #*01 

2160 LDA tt$FA 

2170 CMP RASTER 

2180 BNE IR fl0 

2190 * 

2200 ;*** SET UP SET1 HALF 
2210 RASTOP LDX #$07 


2220 DEY 

2230 LDA K*99 

2240 ? 

(c) 1982 CoiHniodof'-’? 


r MAKE SURE DECIMAL MODE IS NOT C FT 
t CLEAR CURRENT INTERRUPT..., 

/...BUT MAKE SURE THE VIC CAUSED IT 


?ASSUME SET2 IS TO BE SET UP 
r (BY PREPARING INDEXES) 
?...UNLESS RASTER >= tFA 
/(IN WHICH CASE DO NOT 'BRANCH 
}...AND SET UP SET1) 


OF SCREEN *** 

;PREPARE INDEXES TO SET! 


/NEXT INTERRUPT AT RASTER = « 9e 


IQ 
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2250 

r 



2260 

IRQO 

STA- RASTER 

2270 

2280 

f 

3TX 

HOLDX 

2290 


LDA 

SlXflSB/Y 

2300 


STA 

nsisx 

2310 


LDA 

S1YPND,Y 

2320 


STA 

YXPAND 

2330 


LDA? 

S1XPND/Y 

2340 

2350 

r 

STA 

XXPAND 

2360 


LDA- 

SPRCOL 

2370 


STA 

S1SC0L./Y 

2380 


LDA 

SPDACL 

2390 

2400 

r 

STA 

S1SDCL/Y 


;LATCH FOR NEXT RASTER INTERRUPT 
;STORE .X FOR LATER USE 

J TRANSFER SHADOW... 

;....x position nss's 

r. .. Y EXPANSION 
?...X EXPANSION 

r STORE SPR-SPR COLLISION REGISTER 
r AND SPR-OATA COLLISION REGISTER 


2410 

2420 IRQ1 

2430 

2440 

2450 

2460 

2470 

2480 

2490 

2500 7 

2510 

2520 

2530 IRQ2 
2540 
2550 
2560 
2570 
2580 
2590 
2600 ; 
2610 ; 


LDY K$OE 
LDA SISPRXrX 
STA SPOX/Y 
LDA SISPRYrX 
STA SPOYrY 
DEX 
DEY 
DEY 

BPL IRQ1 

LDX HOLDX 
LDY £507 
LDA S1C0LR , X 
STA SPOCOL r Y 
LDA S1SPTR,X 
STA- SPOPTR , Y 
DEX 
DEY 

BPL IRQ2 


;TRANSFER SHADOW... 

} . .-.X POSITION LSB'S 
; . ... Y POSITION 


^TRANSFER SHADOW.... 
F.... SPRITE COLORS 
7 ...SPRITE POINTERS 


2620 EXIT 

PLA 

2630 

TAY 

2640 

PLA 

2650 

TAX 

2660 

PLA 

2670 

RTT 


/RESTORE REGISTERS 


2680 ; 
2690 r 
2700 r 


2710 
2720 
2730 
2740 
2750 
2760 
2770 
2780 
2790 
2800 
2810 
^820 

1982 


DICDAT }SAMPLE SETS OF SPRITE DATA 

.BYT $13,$30 -$43,560,573 ,590,$A3,5C0 
.BYT $18,$30,$48,$60,$78,$90 r$A8 , $C0 
$00/500 /X ftSS'S / GET 1 3 SET2 
$32,$36/$3A/$3E/$42,$46,$4A,$4E 
5E5/5E1/50D/5D9/5D5/5D1/5CD/5C9 
$C0/$C1/$C2/$C3/$C4,$C5,$C6,$C7 
5C3/5C9/5CA/5C3/5CC/5CD/5CE/5CF 
$00/$01/$02/$03/$04,$05,$07,$07 
509/509/50A/50B/50C/50D,50E,50F 
$00,$00 ;X EXPANSION / CET1 & S 
500,500 ,Y EXPANSION / SET1 & S 


( c ) 


.BYT 

.BYT 

.BYT 

.BYT 

• BYT 
.BYT 

• BYT 
.BYT 
.BYT 

CodMttodor*- 


?X LSB'S / SET1 
'X LSB'S / SET2 

' Y POO'S / SET 1 
;Y POS'S / 3£T"> 

;data pointers"/ o PT i 
iOflra pointers / 
iSPR COLORS /SET? 

sif R MWRS / SIt2 

ET2 

P3S* 11. 


-.litiyajfr. 




* 4 
■ J 
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2830 ; 
2340 . £?(D 
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12 






Andy'F'inkel 


APP NOTE 10053. 


AULTI-SPPXTE PROCESSOR 


SOFTWARE A: P P L I C A TX O K 
NOTE 10053 

AUTHOR : Andy Finkel 

SUBJECT ; ttu 1t i — spri te processor 

TV STANDARD ; NTSC or PAL 

ABSTRACT 

This applications note describes 3 method Tor* displaying up to 

32 sprites on the screen at the same- time- throush software interrupt 

s 

control.. Four 'shadowf VIC-II chips are created and maintained by 
the mu-lti-spr i te routine-.. The shadow- re-s i strers on the. chips are 
mapped into the actual UIC—II hardware sprite resisters under 
interrupt control— 


EXPOSITION 


The Multi-sprite routine is an IRQ driven interrupt routine 
which can maintain up to 4 shadow VIC-IT chips. Each of the shadow 
chips is assigned an area of the screen by the pro Scammer. Each 
chip has the use of the 3 sprites in its. section of screen , 3 s well 
3 -s control of the background color. Any- spri tes used by a shadow 
c hjp must stay in the 3rea controlled by that shadow chip. If this 
rU \ g is violated/ it is possible that the sprite will not be 
^jgplaysd. The follow ins charts shows the area of control f Qr 
0 f the 4 shadow VIC-II chips. 


rase 1 
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MULTI-SPRITE PROCESSOR 


CHIP RASTER LINE OF 
INTERRUPT (CEN) 


AREA OF CONTROL 


0 

1 

2 

3 


48 

LOO 

160 

199 


49-100 

101-160 

161-199 

200-48 (wraps 3round to the top of 

the screen) 


Note that the- bottom of the 3rea oP control o? each chip j- 3 
def i ned by the start of the ares of control of the next chip, j.* 
the- bottom of chip l r s area is defined as the besinnins of chip 2's 
area- The areas of control can be. changed dynamicallyr but should 
? be at least. 21 raster lines apart when usins un expanded (in Y) 

spritesr or 42 raster lines apart when usins Y expanded sprites. 

There are- Pour main control locations.- one Por each of the 
shadow chips, called CEN (Chip- ENable) i r. the routine. If one of 
the CEN locations contains a Or that chip is DI5A8LED. Otherwise, 
each is to be set to one before the desired raster line of the 3r( , s 
of control for the chip.. The backaraund color is chansed one raster 
line later. The new sprites are activated several ra-?+*<^ i;- 

» o » til, T^S 

after that. 

LIMITS 

Care must be taken that a sprite maintained by n«- . nrr 

■ 3 c, => one pseudo Vic 

chip does not wander into the 3rea under the control p .. MTr 

o i oP another UIC 

chip. If this happens, one of the sprites wi\\ ro x . , 

* noT ' be displayed. 


9/15/32 
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ttULTI-SPRITE PROCESSOR 


Generally, the- sprite that belongs in that 3rea will have priority. 

IP it is desired to have a spri te. that can so anywhere on the 
screen.- the easiest metho-d is to duplicate the- parameters (position, 
color, and pointer) in each oP the OIC chips. That way, the 
appropriate OIC chip will display the sprite.. 



(C) 1982 Commodore 
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MULTI-SPRITE 


toe: 


SOURCE LISTING 


1000 . 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
1120 
1130 
11/40 
1150 
1160 
1170 
1180. 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1200 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 


.PAG ' DPROC' 

r 

rs- LIST PROCESSOR 

r 

*•=$0002 

CEN *=*+4 ; CONTROL FLAGS FOR CHIPS 

r 

CHIP *=*+1 

;SHAOOW VIC CHIP REGISTERS 

PSPRO *■=*■+16 JLS8 FOR CHIP #1. 

PMS3XQ -x=*+t ;X .153 FOR CHIP ttl 


PSPR1 *-=*-+16 

PP1S3X1 *=*+l 

PSPR2 *-=*-+16 

PMSBX2 *=*+1 

PSPR3 *-=*+16 

PMS3X3 *=*-+! 

7LSB FOR CHIP tt2 
;X (1S3 FOR CHIP «2 

7LSB FOR CHIP H3 
;x ,133 FOR CHIP HE 
?LSB FOR CHIP tt4 
rx MSB FOR CHIP »«. 

PSPTRO *-=*+8 

PSPTR1 *=*+8 

PSPTR2 *-=*+8 

PSPTR3 -*=-*+3 

^SPRITE POINTERS FOR CHIP #1 

7 SPRITE POINTERS FOR CHIP 

7SPRITE POINTERS FOR CHIP ft3 

7SPRITE POINTERS FOR CHIP <K 

7 

PSCLRO *-=*•+8 

PSCLR1 -*=*+8 

PSCLR2 *=*+8 

PSCLR3 -*=.++3 

7SPRITE COLORS FOR CHIP t*l 
7-SPRITE COLORS FOR CHIP |*o 
7SPRITE COLORS FOR CHIP i»3 

7SPRITE COLORS FOR CHIP fK 

COLORO *-=*■+! 

COLOR! -»=*+l 

C0L0R2 *■=*•+! 

C0L0R3 *=*+L 

7C0L0R FOR CHIP ff0 

7 COLOR FOR CHIP m 

7C0L0R FOR CHIP «2 
;COLOR FOR CHIP tt3 

PSCOLO *=*+1 

PSC0L1 -*=*-*•! 

PSC0L2 *■=*•+! 

PSC0L3 *=*+1 

?SPR-SPR COLLISIONS FOR CHTP m 
73PR-5PR COLLISIONS FOR r" { \~ U 
7SPR-SPR COLLISIONS FOR ch?p !? 

!3PS - SPS collisions for cm? 5J 

PSDCLO *-=*+1 

PSDCL1 *=*■+! 

PS0CL2 *=*+1 

PS0CL3 *=*+1 

?SPR-OATA COLLISTf»«o 

7 SPR-OATA COLLISION- K? ^HIP ttl 

7SPR-OATA COLLISIONS » 2 

;SPR-OATA COLLISION- An CHIP * 3 

'-'-■Lai QMS FOR CHIP »4 

T 

;*• VIC CHIP REGISTERS 
• 


T 

SPRX =$0000 

SPRY =$0001 



r* 
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dULT'I-SPR ITE PR0C23G0 


1510 rtSIGX 
1520 RASTER 
1530 SPENA 
1540 VIRa 
1550 VENABL 
1560 SPRCOL 
1570 SPOACL 
1580 8C0L0R 
1590 SPRCLR 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1700 
1790 
1800 
1810 
1320 
1830 
1340 
1850 
1360 
1870 
1880 
1390 
1900 
1910 
1920 
1930 
1940 
1950 
1960 

1970 LAY 
1980 
1990 
2000 
2010 
2020 
2030 
2040 


=•$0010 

=$0012 

=$0015 

=$0019 

=$001A 

=$D01E 

=$D01F 

=$ 002 ! 


SEI 

LDA $OCOE 
AND #254 
STA $DC0E 
LDA $DC0D 

LDA #>DISPLY 
STA- $0315 
LDA #<DISPLY 
STA- $0314- 

LDA #IRVAL 
STA- CEN- 
LDA #90 
STA CEN+l 
LDA : #130 
STA- CEN-i-2 
LDA #170 
STA CEN+3 

LDA CEN 
STA- RASTER 
LDA H$00 
STA CHIP 

LDA #$1 
STA VENABL 

LDX #14 
LDA #$40 
STA PSPRO+1r X 
LDA #100 
STA PSPRl-t-1, X 
LDA #160 
STA PSPR2+1 t X 
LDA #$E0 
STA PSPR3+1 t X 


=$0027 

POINT =2040 
;CONSTANTS 

r 

IRVAL =47 
*=$C000 
INIT 


9/15/82 


}SPRITE POINTERS 

) INTERRUPT 1 RASTER LINE BEFORE ... 


; TURN OFF TIP.ER 

;CLEAR ANY LAST INTERRUPTS 
JSET NEW- INTERRUPT VECTOR 


r SET UP CHIP ENACLE FLAGS 
}(CHIP 0 SHOULD ALWAYS BE IRVAL) 


;SET FOR 1ST INTERRUPT 


JENABLE INTERRUPTS ON RASTER 


;S£T THE Y REGISTERS 


(C) 1982 CoficModor* 
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2050 

r 



2060 


TXA 


2070 


LSR 

A 

2080 


TAY 


2090 

7- 



2100 


LDA 

XTAB,Y 

2110 


STA 

PSPROrX 

212.0 


STA 

PSPRlrX 

2130 


STA 

PSPR2/X 

21 AO 


STA 

PSPR3rX 

2150 

r 



2160 


DEX 


2170 


DEX 


2180 


BPL 

LAY 

2190 

?• 



2200 


LDY 

#31 

2210 

PAG 

LDA 

tt 192 

2220 


STA 

P3PTR0 1 Y 

2230 

9 

r 



2240 


TYA 


2250 


STA- 

PSCLRO r Y 

2260 


DEY 


2270 


8PL 

PAG 

2280 

*■ 

r 



2290 


LDA 

HO 

2300 


STA 

PilSSXO. 

2310 


STA 

PdSBXl 

2320 


STA 

PHS3X2 

2330 


STA 

PKS8X3 

2340 

v 

r 



2350 


LDY 

S3 

2360 

LAG 

TYA 


2370 


STA- 

COLOROrY 

2380 


DEY 


2390 


BPL 

LAG 

2400 

r 



2410 


LDY 

#62 

2420 


LDA 

#255 

2430 

CSl 

STA 

53000 r Y 

2440 


OEY 


2450 


BPL 

CSl 

2460 

r 



2470 


LDA 

#255 

2480 


STA 

SPENA 

2490 

r 



2500 


CLI 


2510 

r 



2520 

HERE 

LDX 

#14 

2530 

HAG 

INC 

PSPROrX 

2540 


INC 

PSPR1 r X 

2550 


INC 

PSPR2/X 

2560 


INC 

p S P R 3 r X 

2570 

r 



2580 


DEX 
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?DIVIDE BY 2 

rSET THE X REGISTERS 


JSET THE SPRITE POINTERS 
TCOLOR IT 


JSET THE COLOR REGS 

} CREATE. THE. SPRITE BLOCK 

;ACTIVATE ALL SPRITES 
;START THINGS OFF 

(C) 1982 Coikmo^q^ 
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MULTI-SPRITE PROCESS© 


2590 

2600 


DEX 

BPL 

HAG 

26|0 

2620 

r 

LDX 

H50 

2630 

Wl. 

LDY 

#255 

2640 

W2 

DEY 


2650 


BNE 

W2 

2660 


DEX 


2670 


BNE 

Wl 

2680 


BEQ 

HERE 


JNOW WAIT 


J ALWAYS 


2690 ? 

2700 XT AD .BYT 24,49,73,99,124,149,164,200 
2710 7 

2720 ; : t xx - x « ■- x -s-a-x-x-s-s-a-x- hh-^ 


2730 7* CHIP LIST PROCESSOR 


2740 t x-x-x-x-x-x-x-x- x-x-x-x-x-x-x-x-x-x 
2750 ; 


2760 

2770 

DISPLY 

T 

LDA 

VIRQ 

2780 

2790 

r 

STA 

V IRQ 

2800 

2310. 

r • 

LDY 

CHIP 


r ASSUME THE VIC CHIP CAUSED THE INTERRUPT 
?CLEAR THE INTERRUPT REGISTER 
?GET THE CHIP WE ARE ON 


2820 


LDA 

COLOROrY 

2330’ 


LDX 

RASTER 

2840 

WAIT 

CPX 

RASTER 

2850 


BEQ 

WA IT 

2860 


STA 

BCOLOR 

2370 

r 



2880 

01 

I NY 


2390 

7 



2900 


TYA 


291.0 


AND 

»603 

2920 


TAY 


2930 

T 




rGET NEW COLOR 

JWAIT BEFORE COLOR CHANCE 


?CHANGE BACKGROUND COLOR 
?GET SET FOR NEXT LINE 
^DO A MOD 3 

;SINCE THERE ARE 3 CHIPS 


2940 

2950 

2960 ; 

2970 

2980 7 

2990 

3000 

3010 r 

3020 

3030 

3040 

3050 

3060 

3070 

3080 f 

3090 VC3 

3100 

3110 > 

3120 


LDA CEN,Y 
3EQ D1 

STA RASTER 

LDX CHIP 
STY CHIP 

CPX HOO 
BEQ VCO 
CPX #$1 
BEQ VC1 
CPX tt$2 
BEQ VC2 

LDA SPRCOL 
STA PSC0L3 

LDA SPDACL 


?GET THE RASTER FOR NEXT CHIP 
rTHIS CHIP IS NOT IN USE 

?SET THE COMPARE REGISTER 

?SELECT PSEUDO CHIP 
;SET FOR NEXT PSEUDO CHIP 

, WHICH CHIP ARE WE DOING NOW ? 
? CHIP 0 

;chip t 

JCHIP 2 

? SAVE OLD COLLISION REGISTERS 
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3130 
3140 ? 

3150 

3160 VC03 
3170 
3180 
3190 
3200 ; 

3210 
3220 } 

3230 VC003 

3240 

3250 

3260 

3270 

3280 

3290 ; 

3300 
3310 } 

3320 VC2 
3330 
3340 ? 

3350 
3360 
3370 } 

3380 

3390 0C02 
3400 
3410 
3420 
3 ; 430 ’, 

3440 
3,450 r 
3460 UC002 
3470 
3480 
3490 
3500 
3510 
3520 ? 

3530 
3540 ; 

3550 VC1 
3560 
3570 ; 

3580 
3590 
3600 J 
3610 

3620 VC01 
3630 
3640 
3650 
3660 ; 


STA PSDCL3 

LDX tt 16 
LDA PSPR3,X 
STA SPRX,X 
DEX |- 
BPL 0003 

LDX H7 

LDA PSPTR3,X 
STA POINT,X 
LDA PSCLR3,X 
STA 3PRCLR,X 
DEX 

3PL 000*03 

BOI DEXI.T. 

LDA SPRCOL 
STA PSCGL2 

LDA SPDACL 
STA PSDCL2 

LDX tt16 
LDA PSPR2,X 
STA SPRX,X 
OEX 

BPL 0002 
LDX tt-7 

LDA PSPTR2,X 
STA- POINT,X 
LDA PSCLR2,X 
STA- 5PRCLR, X 
DEX 

3PL 0C002 

Ml DEXIT 

LDA SPRCOL 
STA PSC0L1 

LDA SPDACL 
STA PSDCL1 

LDX tt16 
LDA PSPRl'X 
STA SPRX,X 
OEX 

BPL 0001 


? GET PSEUDO SPRITE POINTER 
JSET REAL ONE 
;GET PSEUDO SPRITE COLOR 
J SET REAL REGS 


; ALWAYS 

? SAOE OLD COLLISION REGISTERS 


;GET PSEUDO SPRITE POINTER 
? SET REAL ONE 
;GET PSEUDO SPRITE COLOR 
? SET REAL REGS 


; ALWAYS 

JSAOE OLD COLLISION 


REGISTERS 


( C) 1982 C o fti i,vo oj o r*■ 


9/15/82 








Andy Finksl 


APP NOTE 10053 
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3670 

3680 VC001 

3690 

3700 

3710 

3720 

3730 

3740 ; 

3750 
3760 ? 

3770 VCO 
3780 
3790 } 

3800 
3810 
3820 ; 

3830 

33-40 UCOO 
3850 
3860 
3870 
3880 ;■ 

3890 
3900 ? 

3910 YCOOO 

3920 

3930 

3940 

3950 

3960 

3970 r 

3980 DEXIT 

3990 

4000 

4010 

4020 

4030 

4040 ; 

4050 .END 


DEX 


OEX 


DEX 


PLA 

TAY 

PLA 

TAX 

PLA 

RTI 


H7 

PSPTR1,X 

r GET PSEUDO SPRITE 

POINTER 

POINT,X 

JGET REAL ONE 


PSCLRL,X 

JGET PSEUDO SPRITE 

COLOR 

SPRCLRr X 

;SET REAL REGS 


VC001 



DEXIT 

fALWAYS 


SPRCOL 

PSCOLO 

SPDACL 

PSDCLO 

ft 16 

PSPRO., X 
SPRX,X 

J SAVE OLD COLLISION 

[ REGISTERS 

VCOO 

ft 7 



PSPTRO,X 

;GET PSEUDO SPRITE 

POINTER 

POINTVX 

FGET REAL ONE 


PSCLRO,X 

?GET PSEUDO SPRITE 

COLOR 

SPRCLR,X 

VCOQO 

}SET REAL REGS 

JRESTORE REGISTERS 



HEX DUMP 

COOO 
r 0008 
; 0010 
: 0013 
s 0020 
: 0023 
; 0030 
; 0033 
; 0040 


78 

AD 

OE 

DC 

29 

FE 

8D 

OE 

DC 

AO 

OD 

DC 

A9 

00 

QD 

15 

03 

A9 

AD 

80 

14 

03 

A9 

2F 

85 

02 

A9 

5A 

85 

03 

A 9 

02 

85 

04 

A 9 

AA 

85 

05 

A5 

02 

80 

12 

DO 

A 9 

00 

05 

06 

A 9 

01 

8D 

1A 

DO 

A2 

OE 

A 9 

40 

95 

03 

A? 

64 

95 

19 

A 9 

AO 

95 

2A 

A9 

EO 

95 

38 

8 A 

4 A 
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C043 

A3 

B9 

A3 

CO 

95 

07 

95 

13 




COSO 

95 

29 

95 

3A 

CA 

CA 

10 

DE 




C053 

AO 

IF 

A9 

CO 

99 

43 

00 

98 




C060 

99 

6B 

00 

88 

10 

F4 

A9 

00 




C06a 

85 

17 

85 

23 

85 

39 

85 

4A- 




C070 

AO 

03 

98 

99 

8B 

00 

88 

10 




C073 

F-9 

AO 

3E 

A9 

FF 

99 

00 

30 




C080 

88 

10 

FA 

A 9 

FF 

80 

15 

DO 




C083 

53 

A2 

OE 

F6 

07 

F6 

13 

F6 




C090 

29 

F6 

3A 

CA 

CA 

10 

F 4 

A2 




C093 

32 

AO 

FF 

03 

DO 

FD 

CA 

DO 




COAO 

F8 

FO 

E6 

18 

31 

49 

63 

7C 




C0A3 

95 

A4- 

ca 

AO 

19 

DO 

00 

19 




COBO 

DO 

A4 

06 

B9 

88 

00 

AE 

12 




C0B3 

DO 

EC 

12 

DO 

FO 

FB 

8D 

21 




COCO 

DO 

C8 

98 

29 

03 

A8 

B9 

02 




C0C3 

00 

FO 

F6 

00 

12 

DO 

A6 

06 




COOO 

84 

06 

EO 

00 

FO 

77 

EO 

01 




C008 

FO 

4E 

EO 

02 

FO 

25 

AO 

IE 




COEO 

DO 

85 

92 

AO 

IF 

DO 

85 

96 




C0E3 

A2. 

1.0. 

B5 

3A 

9D 

00 

DO 

CA 




COFO 

10 

FB 

A2 

07 

B5 

63 

90 

F8 




C0F3 

07 

B5 

33 

90 

27 

DO 

CA- 

10 




C100 

F3 

30 

60 

AO 

IE 

DO 

85 

92 




Cl. 03 

AD 

IF 

do: 

35 

96 

A2 

10 

B5 




Clio 

29 

90 

00 

DO 

CA 

10 

F8 

A2 




Clio 

07 

B5 

53 

90 

F8 

07 

B5 

73 




C120 

9D 

27 

DO 

CA 

10 

F3 

30 

48 




Cl 23 

AO 

IE 

DO 

85 

90 

AD 

IF 

DO 




C130 

05 

94 

A2‘ 

1.0 

B5 

18 

90 

00 




Cl 33 

DO 

CA 

10 

F8 

A2 

07 

B5 

53- 




C1.4Q 

90 

F8 

07 

B5 

73 

90 

27 

DO 




Cl 43 

CA 

10 

F3 

30 

23 

AO 

IE 

00. 




C150 

85 

8F 

AO 

IF 

DO 

85 

93 

A2 




C158 

10 

B5 

07 

90 

00 

DO 

CA 

10 




Cl 60 

F8 

A2 

07 

B5 

4B 

90 

F9 

07 




C163 

B5 

6B 

90 

27 

DO 

CA 

10 

F3 




C170 

68 

AS 

68 

AA 

68 

40 





DATA STATEMENTS 









DATA 

120 r 

172 

! T 

14 


220 

f 

41, 

254, 141 

/ 14 

DATA 

220 , 

173, 

13 


220 

r 

169 r 

192, l.^l, oi 

DATA 

3, 169 r 

171 r- 

141, 

20, 

3, 169, 

47 

DATA 

133, 

2, 

169, 

90, 

133, 

3, 169, 

130 

DATA 

133, 

4, 

169, 

170, 

i: 

33, 

5 , 165 , 

2 

DATA 

141,- 

13, 

203 

r 

169 

, i 

0, 

133, 6 , 

16? 

DATA 

1, 141, 

26, 

208, 

1 6 2 r 

14, 169, 

64 

DATA 

149, 

3, 

169, 

100, 

149 , 

25, 169, 

luQ 

DATA 

149, 

42, 


169 


22 4 

r 

149, 

59, 13Q 

, 74 

DATA 

163, 

185 1 

163 r 

192, 

149 

r 7, 147 

/ 24 

DATA 

149, 

41 , 


149 

t 

58, 

202, 

202, 16, 

222 

DATA 

160, 

31, 


169 

r 

192 

r 

153, 

75, 0, 

152 

DATA 

153, 

107 


0, 

1 

36, 

16, 

244, 169, 

0 


? 3 
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DATA 

133, 

23, 

133, 40, 

133, 57, 133, 74 

OATA 

160, 

3, 

152, 153, 

139, 0, 136, 16 

DATA 

249, 

160, 

62,- 169, 

255, 153, 0, 43 

DATA- 

136, 

16 r 

250, 169,- 

255, 141, 21, 208 

DATA- 

88, 

162, 

14 , 246, 

7, 246, 24, 246 

DATA 

41, 

246, 

50, 202, 

202, 16, 244, 162 

DATA 

50, 

160, 

255, 136, 

203, 253, 202, 203 

DATA 

248, 

240, 

•230, 24, 

49, 73, 99, 124 

DATA 

149, 

164, 

200, 173 

, 25, 203, 141, 25 

DATA 

208, 

164 , 

6, 185, 

139, 0, 174, 18 

DATA 

200, 

236, 

13, 203, 

240, 251, 141, 33 

DATA 

208, 

200, 

152, 41, 

3, 168, 185, 2 

DATA 

0, 

240, 

246, 141, 

13, 203, 166, 6 

DATA 

132, 

6, 

224, 0, 240, 119, 224, 1 

DATA 

240, 

73, 

224, 2, 

240, 37, 173, 30 

DATA 

208, 

133, 

146, 173 

, 31, 208, 133, 150 

DATA 

162, 

16, 

181,- 53, 

157, 0, 203, 202 

DATA 

16, 

2.48, 

162,, 7, 

181, 99, 157, 248 

DATA 

7, 

131, 

131, 157, 

39, 200, 202, 16 

DATA 

243, 

48, 

109, 173, 

30, 208, 133, 146 

DATA 

173, 

31, 

203, 133, 

150, 162, 1.6, 181 

DATA 

41, 

157, 

0, 208, 

202, 16, 248, 162 

DATA 

7, 

181, 

91, 157, 

243,- 7", 13 L,- 123 

DATA 

157,- 

39, 

208, 202, 

16V 243, 48, 72 

DATA 

173, 

30, 

203, 133, 

144, 173V 31, 200 

DATA 

133, 

148, 

162, 16, 

18Lr 24, 157, 0 

DATA- 

203, 

202, 

16, 243, 

162, 7, 101, 03 

DATA 

157, 

248, 

7, 181, 

115, 157, 39, 20e 

DATA 

202, 

16, 

243 , 43, 

35, 173, 30, 203 

DATA 

133, 

143, 

173, 31, 

208, 133 r 147, 162 

OATA 

16, 

131, 

7, 157, 

Or 208,- 202, 16 

DATA 

24-8, 

162, 

7, 181, 

75, 157, 240, 7 

DATA- 

181, 

107, 

157, 39, 

203, 202, 16, 243 

DATA 

104,. 

160, 

104, 170 

, 104, 64 



V 
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* * , - J ^ _l ■— 11 1"“* —- s Joe McEnerney end Eric Cotton 

■s-c.-fc = Addressing the Video end Color Matrices 
x•=-x sr ± -r.r-i 3“t.=*• j-.J.=. j— c4 = NTSC or PAL 


to 

by 


I - Ms“t:r—.=4.i^_-h: r fhe purpose ot this application note is 
-Upf-'ly .=*. method ot* addressing the uideo and color matrices 
i-Pe'-itying roi;j end column numbers tor the matrix element ot concern. 
Thi^. ^w-ill be achieved using the indirect indexed addressing mode ot* 
the *50x microprocessor and an auxi liary table. 


^ X ~T~ I ON = In order to address an arbitrary 

* lem»-rit ot any matrix ot bytes stored in memory the user must have a 
base address B, a row number R, a column number C, the number ot 

rows NR, and the number ot columns NC. The number R must satisty the 

inequality 0 <= R <= NR-1 and C must satisty 0 O C <> NC-1. The 

•=*ddr*=*i.s, AE, ot an arbitrary element can be tound by per term i ng the 

ca leu lat i on 

AE = R.tNC+C+B. 

TF'iis tor mu la requires one multiply and two- add i t i ons to tind A. This 
is a rather high price to pay in execution" time arid memory. To so loe 
these problems one can store the precalculated values RtNC+B, 0 <= r 

•.= NR= 1 in a table and use C as., an index value. These table entries 

^ r n tact, the addresses ot the tirst element ot each row ot th«=» 
matrix. Now, in our application ot this principle, the matrix has 25 
rows '..NR=^5..' and 40 columns 0**10=40''. The base address is chosen by 

the user by selecting the high address bits VM13.. VM1R i r 

register 24 <$18> ot the 6566/6567 VIC II chip. By pre-.-a lr, j i*+ i ►- -1 
the table ot addresses ’ ~ 

40tR, 0 O R <= 24 

and using C as the value in the y index register, o/-, arhit 

location in the video matrix cari be accessed. In what tn l Ini' 

ye.lue ot E<* wi 11 be calculated trow trorn VIC register 24 ^ 

the user must also note that the matrix ot color nybb 1*=.=*° 

=r. base address. 


Mo r e o v e r, 
has $0800 


Pl m Program l i st i ngs : 
1. Source: 


<*/14/82 


Commodor 


page 1 


• . 





1 000 
1010 
1 020 
1 030 
1040 
1 050 
1 060 
1070 
1 030 
1 030 
1 1 00 
1110 
1120 


.PAGE -'SET POINTERS' 

9 

/ 

: SET UP POINTERS TO VIDEO & COLOR MATRICES 

: USING CVPTR] .& CCPTRD 

;SET VIDEO & COLOR MATRIX POINTERS USING THE 
;VALUE IN THE X REGISTER AS A ROW NUMBER 


VPTR 

CPTR 

VIC 


$=$@020 
*=*+2 
*•:=*+2 
=$0000 


;OR SOMEWHERE IN PG 0 
;POINTS AT VIDEO MATRIX 
;POINTS AT COLOR MATRIX 
?START OF VIC REGISTERS 

;FOR TEST ASSEMBLY 

GET THE ROW ADDRESS LOW 
;STORE IN VIDEO POINTER LOW 
;STORE IN COLOR POINTER LOW 
;GET THE VM BASE ADDRESS 
;CLEAR LOW BITS 

RIGHT SHIFT IT TWICE 
;TO ALIGN IT PROPERLY 
,:0R IN THE HIGH OFFSET 
;STORE IN VIDEO POINTER HIGH 
.J CLEAR ALL BUT 2 LSBS 
;0R IN COLOR BASE HIGH 
;STORE IN COLOR POINTER HIGH 


1300 }STARTING ADDRESS TO $0000. THE FIRST ARRAY CON®T~r© n£ 
° 1 ,T< ;THE LOW ORDER BYTE OF THE ADDRESS OF THE FIRST p-tp 

. c*m:i ricr t-ljc- urnen Mr.Tnru -pi ir- — - t* T I t Ur 


1130 

/ 

#*$S 

5000 

1140 

1150 

SETPTR 

LDA 

RALT,X 

1160 


STA 

VPTR 

1170 


STA 

CPTR 

1130 


LDA 

V7C+24 

1190 


AND 

ft$P0 

1 200 


LSR 

A 

1210 


LSR 

A 

1220 


ORA 

RAHT,X 

1230 


STA 

VPTR+1 

1240 


AND 

#3 

1250 


ORA 

#$03 

1260 


STA 

CF'TR+1 

1270 

1230 

m 

RTS 


1230 

;THESE 

ADDRESSES C 


;0F 


1310 
1320 
1330 
1340 
1350 
1360 
1370 RALT 
13S0 
1390 
1400 
1410 
1420 
1430 


H ROW OF THE VIDEO MATRIX. THE SECOND ARRAY rmcror 
THE HIGH ORDER ADDRESS BYTE. THESE VALUES RPF iten 1 ' 
;iu SET UP THE HIGH ORDER BYTE OF THE ADDRESS t!ro npfSr 
;0F THE ALIGNED BASE WITH THE APPROPRIATE TABLE ENTF" 


RAHT 
. END 


. BYTE $00 , $28, $50 , $73 , $A0, $C3, 

. BYTE $40, $68$90, $88$E0 $0S ’’ ' fe * 

. BYTE $80 , $AS , $D0 , $FS , $20 , $43 " $?n ' ™ 
.BYTE $C0 J '^° 

. BYTE 
. BYTE 


0 , 0 , 0 , 0 , 0 , 0 , 0 , 1 , 1 , 1,111 •? 

«-% ^ f-j ."5 ^ X A ^ .* C.' jr cl ‘ 

•i / cl / c / c. .*• / O 
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3. De.te. statements es assembled e.t $3000> s 


1006 data 1 S3,26,48 , 133, 32, 133,34,173,24, 208,41,240,74,74,23,51 
1 0 10 data 48 , 133,33,41, 3,3,216,133,35,36,0,40,30,120,160,200 
1020 data 240,24,64,104,144 , 184,224,3,48,88 , 128 , 168.208,248 *32,72 
1030 data 112,152,132,0,0,0,0,0,0,0 , 1 , 1 , 1 , 1 , 1, 1 


1 fiuifi .*•*,=,+ =« Z> O Z* Z* Zf z* T' o o o 

1 - ^ / k- / »- / c. / c. / t / c. / o ,r ,p O / O 


C. Memory/Register requirements: This routine requires 76 <$4C> 
bytes of code including tables. It aIso expects the now number to be 
in "the x register e."t -JSR "time. The accumu l at or is used bu"t "the y 
register is not. 


D. Worst case execution time is 41 <$23> cycle 
this is 40.2 micro-seconds.> 


;. <flt 1.02 mHz 


E. Examples: 

1. To change a video matrix entry at ROW 10 and COL 15 to 
character number127 and the corresponding color code to 7 <yellow> 
one can use the to l lowing code: 


cou Id use: 


LDX 

#10 

y <. ROW #> 

LDV 

#15 

• <COL #> 

JSR 

SETPTR 

SET UP POINTERS 

LDfl 

#127 

;CHR# 127 

STfl 

<VPTR),V 

;STORE 127 0 VMCROW, COL) 

LDfl 

#7 

} 

STfl 

CCPTR),V 

f STORE 7 0 CM<ROW, COL) 

To r 

'•ead the c 

.haracter code at ROW 1@ and COL 

LDX 

#10 

; -.'ROW #> 

LDV 

#15 

< COL #) 

JSR 

SETPTR 

f SET UP POINTERS 

LDfl 

< VPTR >,V 

)LOAD .fl WITH VMCROW, COL) 


15, one 
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SCROLLING 


3 o- F "fc. *■* -3 A r» r» L i c <3 "t, i on 

N5o-t^r 2 0 0 2 


Author's. J Jeff Bruette: 3nd An-da rink-el 


Sub.i "ict ^ Horizontal Scrolling 


Te l ev I. is i on S tanris-r d - NTSC 


I- Abs-t r-sc -t t This scrolling routine performs all of the 
-Functions- necessary to smooth la scroll the screen left or risht. In 
one passv it can scroll ana increment -from one bit to one bate. The 
Main use of this routine would be- For effects in which the- landscape 
move ba.. Characters- and color memory both move. 


C X _ lX5<r»o-s i -fc. f: on ~ The users- rro-Sra-.u should call the 
routine labeled "SETIRQ". This will set up the routine variables 
and the r3svter inte-rup-t routine.. Since the speed of the scroll i 3 
user def inabler the user must store the speed in the variable called 
"SPEED". This may. be done as often- as necessarsr but iF the speed 


desired is to be constant. once is enough. 

SPEED is expressed in two's compliwent form and the valid 

ranges are 0 <= SPEED <> 8 oi- 8<tf8> <= SPEED O -l(*ff>. 

Therefore* mov i ns -»F3 scrolls 3 bits at 3 time -From risht to left 

whil* *08 scrolls 8 bits at a time -From left to right. These 

numbers reFlect the number o-F bits moved evera 1/dOth oF a second 

(one screen scan of the raster) . This holds true onla if 

i-outi ne labeled "BITttOO" is C3ll at least once evera 1/dQth <• 

1 * U f 3 
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SCROLLING 


second. 

Assume that you character rows 3 ($03) throush 12 ($0C) were to 
be scrolled? while- 311 other rows were stationary.. There is 3 
formula to fisure row/rasterl i ne values. The formula .is: CHARACTER 
ROW $ 8 -t- $2A * TOP RASTER OP THAT ROW. In this example? the roster 
line for the top would be $42. This number should be placed in the 
con-st3nt that is named "TOP". The same formula should be used -foi¬ 
es Iculat ins the bottom raster line butr add $07 to the answer. In 
this example? that number would be 12 ($0c). The answer is be $0A. 
Since we are scroll ins rows 3 ($03) throush 12 ($00? ".here are 10 
($0A) Vines be ins scrolled.. Put this number in "ROWS". 

The startins address of the top scroll row is also needed. This 
number minus 40 ($28) wi-11 sive 3 two byte address. The h i sh byte 
should, be put in “HIBYTS". In this example? this would be an $04. 
The- lou byte- is 3 $28. This should be- put in "L08YT". The only 
constant remaining is "HIBYTC".. This is the hish byte of th* top of 
the- color- ram 3rea beind scrolled*- Assumind that the start of 
screen memory is at. 1024 ($0400)? "HIBYTC" would be "HYBYTS" t- $04 

Put 3 $08 in the "HIBYTC" constant.. Once these rhanac- , 

- Lrunsiss 3re made? 

this routine should be-ready to use. 

A note that should be made is that, this rau+i-.- .. .. , 

must be used in 

the 38 column mode. This is an imrortant Point tn 

^ *?° make if the 

application note which deals with on screen detect!-,., • . • 

-'•'action is bein-d used. 

Also? there are two changes to make in RASTWT if u „.. 

1T you are usins 

multi-color mode. These chandes are commented. 

Another point which needs mention ins i s 3 description of the 
YERPLT routine. This is a routine which must be supplied by the 
user. What it must do is place characters and/or colors which are 
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SCROLLING 


bei nd introduced as new pictures. These char3cter/colors should be 
put on the screen in the proper column. The proper column is 
3utowat i ca ly stored in the- variable rawed COLUflN. An example o-f 
YERPLT is used in the demonstration program. This routine does not 
put up new in-formation on the screen r but rather "wraps'* i n*f ortaat i on 
•frofiv one side o-f the screen around to the opposite side 01 * the 
screen (i.e. puts column 0 into column 3? or puts column 3? into 
coluom 0). 
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SCROLLING 


Character Row 


/ P"T »=: ft. o r— ^ 
C !n 3-r -fc. 


L o o o "t, i or 


Row 
Mo. 

1 

1 

ttem-. 

Loc.. 

1 

Meifi«. 

Loc.. — 

501 

1 

50400 

1 

50398 

02 

1 

0420 

» 

0400 

03 

1 

0450 

1 

0428 

04 

1 

0478 

1 

0450 

05 

1 

04 AO 

I 

0473 

06 

1 

04CS 

1 

04 AO 

07 

1 

04F0 

1 

04C8 

08 

J 

0518 

1 

04F0 

09 

1 

0540 

1 

0513 

OA 

1 

0568 

1 

0540 

OS 

1 

0590 

1 

0563 

OC 

1 

05e8 

J 

0590 

00 

1 

05E0 

1 

05S3 

OE 

1 

0608 

1 

05E0 

OF 

1 

0630 

j 

0603 

10 

I 

0658 

1 

0630 

11 

1 

0680 

1 

0653 

12 

I 

06A8 

1 

0680 

1J 

1 

0600 

1 

06A8 

14 

1 

06Fe 


06D0 

IS 

I 

0720 


06F3 

16 

1 

0748 


0720 

17 

J 

0770. 

1 

0740 

18 

J 

0798 

1 

0770 

19 

1 

07 CO 

| 

0793 


- 523 


3 o i-j «■"• ci »=:- l_ i s t i n 3 — 


2640 

2650 

2660 

2670 

26S0 

2690 

2700 

2710 

2720 

2730 

2740 

2750 

2760 

2770 

2780 

2790 

2800 

2305 

2eio 

2320 

2830 


; s*****^-:frs-s*:f-*-s**“f-&#••$$- 
r* SMOOTH SCROLL ROUTINE 
1* WORKS FOR EITHER 
;s RIGHT OR LEFT 
x--:fr * x :< - * fr - c-x - :c - z -x-n- xx :c a :c * 


;* DECLARE THESE 
*=50002 
SPEED *=*+1 
SCRNL0 *=*+2 
SCRNHI *=*+2 
C0LRL0 *=*+2 
COLRHI ;c=*+2 
DELAY 1 -*=*+1 
XPflOV *=*+1 
FLA61 *=*-H 
COLUMN *=*+1 
ROWS =525 
HIBYTS =503 
HISYTC =5D7 
L0BYT =598 


VARIABLES * 


?SCROLLING SPEED 
'LOW. SCREEN AD0RES3 

!S5 H C o5R E !!eJSJ? 6 ®j A00RESS * 

f«M!!iiK 3 < l " ado. 

'SCR0LX L00KALIKE ETE '' LAl3 
?NUMDER N 0F H R0W3^?L T ^ be nooIFIE:D 

IKiSS ml jj ScSiS*.SSS^SrHu. « 

- vast s a 
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2340 

TOP 

=152 


;VAL. OF RASTER LINE AT TOP OF SCROLL 

2850 

XEOR 

= 1FB 


? TOP EOR*d WITH XEOR = BOTTOH RASTER 

2851. 

IRQVEC 

=1314 


r ON C6-4. .. CHANGE FOR GAME 

2852 

JCIAICR 

=iOCOD 

JTHESE ARE IN STANDARD RAX DECLARE FILE 

2353 

r RASTER 

=<0012 


2854 

JVICIRQ 

=<0019 


2855 

;SCROLX 

=<0016 


2856 

;IRQMSK 

=<001A 


2857 

j CIACRA- 

=<OCOE 


2858 

rCIAPRA 

=<0C00 


2860 

*=iCOOO 



; ASSEMBLE AT iCOOO 

2370 

3ETIRQ 

SEI 


/TURN OFF ALL OUTSIDE INTERUPT3 - 

2880 


LDA 

Hi7F 


2390 


3TA 

CIAICR 


2900 


LDA 

ClAICR 


2910 


LDA 

Hi 01 

rSELECT RASTER TYPE INTERUPTS 

2920 


STA 

IRQMSK 


2930 


LDA 

HiOO 

? ZERO OUT VARIABLES 

2931 


STA 

XPMOVE 

?SCROLX LOOKALIKE 

2940 


STA 

CIACRA 

• 

2950 


STA 

DELAY1 

• 

2960 


STA 

COLUMN 


2970 


LDA 

HiTOP 

rRASTER LINE OF TOP OF SCROLL 

2930 


STA 

RASTER 


2990 


STA- 

FLAG1 


3000 


LDA 

HXRASTWT 

J GET THE LSB OF INTERUPT ROUTINE 

3010 


STA 

IRQVEC 


3020 


LDA 

H>RASTWT 

JGET THE MSB OF INTERUPT ROUTINE 

3030 


STA 

IRQVEC+L 


3040 


LDA 

HiCO 

}INITIALIZE THE ' SCROLX ’ 

3050 


STA 

XPMOV 

fLOOKALIKE" VARIABLE 

3060 


CL I 



3070 


RTS 



3080 

; ****** 

UPDATES ZERO PAGE SCROLX LOOKALIKE ****** 

3090 

BITMOV 

LDA 

DELAY1 

?GET DELAY1 FLAG 

3100 


BEQ 

BITRTS 

r BRANCH IF RASTER HASN'T MADE A PASS 

3110 


LDA 

HiOO 

?CLEAR OUT DELAY1 FLAG 

3120 


STA 

DELAY1 


3130 


LDA 

XPMOV 

J GET THE SCROLX LOOKALIKE 

3140 


CLC 



3150 


ADC 

SPEED 

JADD THE DISTANCE TO SCROLL. MUST BE; 

3170 


STA 

XPMOV 

? STORE NEW OFFSET 

3180 


TAX 



3190 


AND 

HiOO 

r CHECK TO SEE IF IT WRAPPED 

3200 


BEQ 

BITRTS 

} BRANCH IF IT HASN'T 

3210 


TXA 



3220 


AND 

Hi07 

;GET THE NEEDED BITS 

3230 


STA 

XPMOV 

;STORE NEW NUMBER 

3240 


LDA 

HiHIBYTS 

}HIGH BYTE OF STARTING... 

3250 


STA 

SCRNLO+1 

;LINE MINUS 40 

3260 


STA 

SCRNHI-i-1 


3270 


LDA 

HiHIBYTC 

?HIGM BYTE OF COLOR RAM 

3280 


STA 

COLRLO+1 


3290 


STA 

COLRH1*1 


3300 


LDA 

KiLOBYT 

;LOW BYTE OF STARTING.. 

3310 


STA 

SCRNLO 

;LINE MINUS 40 

/15/02 
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3320 


TXA 

3330 


BMI 

3340 


SPL 

3350 

BITRTS 

RTS 

3360 

;****** 

MOVE 

3370 

RLMOVE 

LDX 

3380 

RLLP1 

LDY 

3390 


LDA 

3400 


CLC 

3410 


AOC 

3420 


STA 

3430 


STA 

3440 


STA 

3450 


STA 

3460 


BCC 

3470 


INC 

3480 


INC 

3490 


INC 

3500 


INC 

3510 

RLLP2 

INC 

3520 


INC 

3530 

RLLP3 

INY 

3540 


LDA 

3550 


STA 

3560 


LDA 

3570 


STA 

3580 


CPY 

3590 


BNE 

3600 


DEX 

3610 


BNE 

3620 


STY 

3630 


BEQ 

3640 

;-:<-**-**-* 

MOVE 

3650 

LRMOVE 

LDX 

3660 

LRLP1 

LDY 

3670 


LDA 

3680 


CLC 

3690 


ADC 

3700 


STA 

3710 


STA 

3720 


STA 

3730 


STA 

3740 


BCC 

3750 


INC 

3760 


INC 

3770 


INC 

3780 


INC 

3790 

LRLP2 

INC 

3300 


INC 

3810 

LRLP3 

LDA 

3320 


STA 

3830 


LDA 

3340 


STA 

3850 


DEY 

3360 


3PL 

3870 


DEX 

9/15/0 

2 



RLMOVE /WRAPPED PASSED ZERO/ BRANCH TO RLMOVE 
LRMOVE ;DIDN'T WRAP, XPMOV WAS JUGT TOO BIG 


SCREEN RIGHT TO LEFT ONE BYTE ****** 


ttROWJ 

«*FF 

<sr 


*40 


/NUMBER OF ROUS. 
;COLUMN 0 MINUS 

/GOT0 NEXT ROW 


SCRNLO 
SCRNHI 
COLRLO 
COLRHr 
RLLP2 
SCRNLO+1 
SCRNHI+L 
COLRLO*1 
COLRHI*L 
SCRNHI 
COLRHI 

JGOTO NEXT CHARACTER 
(SCRNHI)rYfGET A CHARACTER 
(SCRNLO)rYJSTORE CHARACTER IN NEW LOCATION 
(COLRHI),Y;GET A- COLOR 
(COLRLO)rYJSTORE COLOR IN- NEW LOCATION 
*39 rlS ROW DONE? 

RLLP3 ;NOY SO BRANCH 


?NO ADJUSTMENT WAS NEEDED/ SO BRANCH 


/AOJUST FOR THE ONE BYTE OFFSET IN MOVE 


RLLPL 

COLUMN- 

YERPLT 


^BRANCH (or JMP) 


SCREEN- LEFT TO RIGHT 0 


JMP) TO USER'S DRAW ROUTINE 
NE BYTE x-x**-xa 


J-NUMBER OF ROWS 
; COLUMN 38 


HROWS 
*38 

SCRNLO 

;GOTO NEXT ROW 

*40 

SCRNLO 
SCRNHI 
COLRLO 
COLRHI 
LRLP2 
SCRNLO+1 
SCRNHI+1 
COLRLO-!-1 
COLRHI+L 
SCRNHI 
COLRHI 

(SCRNLO),Y?GET A CHARACTER 

(SCRNHI ),Y;PUT CHARACTER IN NEW LOCATTrM 
(COLRLO)/Y'/GET A COLOR ' Ari( ^ 

(COLRH I )/ Y /STORE. COLOR IN NEW LOCATTom 
;NEXT ONE? 


/NO ADJUST NEEDED/ SO BRANCH 


/ADJUST FOR THE ONE BYTE OFFSET IN MOVE 


LRLP3 


/NO/ SO BRANCH 


(C) 1902 Corr«Hiodor--=r 






APP NOTE 2002 


SCROLLING 


3000 


ONE 

LRLP1 

? GOTO NEXT ROW IF NOT DONE 


3090 


3TX 

COLUMN 



3900 


BEQ 

YERPLT 

JBRANCH (or JMP) TO USER'S PLOT 

ROUTINE 

3910 

;•**-*-*-** 

RASTER DRIVEN 

INTERUPT ROUTINE -:s-k-:<hc-*-:c- 


3920 

RASTWT 

LDA 

VICIRQ 

;CLEAR THE IRQ 


3930 


STA 

VIC.IRQ 



3940 


AND 

tt$01 

MS IT A RASTER INTERUPT 


3950 


BEQ 

RASLP1 

fNOr SO BRANCH 


3960 


LDA 

FLAG1 

t GET THE RASTER TOGGLE FLAG 


3970 


EOR 

.IX EOR 

;CALC.. NEW RASTER LINE 


4000 


STA 

FLAG1 

;ST ORE NEW STATUS 


4010 


STA 

RASTER 

'SET THE NEXT RASTER LINE INTERUPT 

4030 


CUP 

ft T OP 

MS RASTER AT TOP? 


40-40 


3NE 

RASLP1 

? NO r SO BRANCH 


4050 


LDA 

XPMOV 

;GET THE SCROLX LOOKALIKE 


4060 


AND 

t»*07 

?SET JUST THE NEEDED BITS 


4070 


ORA 

«*C0 

TOR ft$D0 FOR MULTI-COLOR MODE 


4080 


STA 

SCROLX 

STORE IT IN THE VIC'S X SCROLL 

LOC. 

4090 


STA 

DELAY1 

MET DELAY1 FLAG <> 0 


4100 


BMI. 

RASLP2. 

f ALWAYS 


4110 

RASLP1 

LDA 

fUCO 

?OR tt$DO FOR MCM 


4120 


STA 

SCROLX 



4130 

RASLP2 

PLA 


JRESET THE STACK 


4140 


TAY 




4150 


PLA- 




4160 


TAX 




4170 


PLA- 




4180 


RTI 




4190 

»END 
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H >=r x D- ft', f- ? 


C00Q 

73 

A9 

7F 

OD 

OD 

DC 

AD 

OD 

COOS 

DC 

A9 

01 

80 

1A 

DO 

A9 

00. 

C010 

8D 

OE 

DC 

85 

OB 

35 

OE 

A9 

coia 

FB 

8D 

12 

DO 

85 

OD 

A9 

C3 

C020 

8D 

14- 

03 

A9 

CO 

80 

15 

03 

C028 

A9 

CO 

85 

OC 

58 

60 

A5 

OB 

COSO 

FO 

2A 

A? 

.00 

05 

OB 

A5 

OC 

C038 

18 

65 

02 

85 

OC 

AA 

29 

08 

C04G 

FO 

1A 

3A 

29 

07 

05 

OC 

A 9 

C04 8 

03 

85 

04 

85 

06 

A9 

D7 

85 

C050 

03 

05 

OA 

A9 

DO 

05 

03 

OA 

C058 

30 

03 

10 

35 

60 

A2 

19 

AO 

C060 

FF 

A5 

03 

18 

6? 

23 

85 

03 

C068 

85 

05 

85 

07 

85 

09 

90 

08 

C070. 

E6 

04 

E6 

0-6 

E6 

08 

E6 

OA 

C070 

E6 

05 

E6 

09 

ca 

B1 

05 

91 

COSO 

03 

BL 

09 

91 

07 

CO 

27 

DO 

C088 

F3 

CA 

DO 

D3 

84 

OE 

4C 

00 

C090 

00 

A 2 

13 

AO. 

26 

AS 

03 

13 

C098 

69 

28 

85 

03 

85 

05 

85 

07 

COAO 

35 

09 

90 

08 

E6 

04 

E6 

06 

C0A8 

E6 

08 

E6 

OA- 

E6. 

05 

E6 

09 

COBQ 

B1 

03 

91 

05 

B1 

07 

91 

09 

C0B8 

88 

10 

F5 

CA 

DO 

D5 

86 

OE 

COCO 

4C 

00 

00 

AO 

19- 

DO 

00 

19 

C0C8 

DO 

29 

01 

FO 

1A 

A5 

00 

49 

CODO 

9B 

05 

OD 

00 

12 

DO 

C9 

FB 

CODS 

DO 

00 

A5 

OC 

29 

07 

09 

CO 

COEO 

80 

16 

DO 

05 

OB 

30 

05 

A9 

C0E8 

CO 

80 

16 

DO 

60 

A8 

68 

AA 

COFO 

68 

40 
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u as •fc, .3 S tsteftven ts ~ 

OATA 120,169,127,141,13, 220 ,173,13 
DATA 220,169,1,141,26,208,169,0 
DATA 141,14,220,133r11r133,14,169 
DATA 251,141,18,208,133,13,169,195 
OATA 141,20,3,169,192,141,21,3 
DATA 169,192,133,12,08,96,165,11- 
DATA 240,42,169,0,133,11,165,12 
DATA 54,101,2,133,12,170,41,8 
DATA 240,26,133,41,7,133,12,169 
DATA 3,133,4,133,6,169,215,133 
DATA 0, 133,10,169,216,133,3,133 
DATA 48,3,16,53,96,162,25,160 
DATA 255,165,3,2-4,105,40,133,3 
DATA 133,5,133,7,133,9,144,8 
DATA 230,4,230,6,230,3,230,10 
DATA 230,5,230,9,200,177,5,145 
DATA 3', 177,9,145,7,192,39,200 
DATA 243,202,208,211,132,14,76,0 
DATA 0,162,24,460,33,165,3,2.4 

DATA 105,40,133,3,133,5,133,7 
DATA 133,9,14-4,3,230,4,230,6 
DATA 230,8,230,10,230,5,230,9 
DATA 177,3,145,5,177,7,145,9 
DATA 136,16,245,202,208,213,134,14 
DATA 76,0,0,173,25,208,141,25 
DATA 208,41,1,240,26,165,13,73 
DATA 155,133,13,144,13,208,201,251 
DATA 20e,13,465,12,41,7,9,192 

DATA 141,22,203,133,41,43,5,169 
DATA 192,141,22,208,104,168,104,170 
OATA 104,64 
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Execu t i on T i rr. -s - 

Since the execution times vary defendins on whet area of the 
screen is be ins scrolled 3nd the speed of the scroll, I have broken 
the routine into sections. 


3ETIRQ Always? 73 cycles 

BITMO.M Best Case; 34 cycles 


One P3ss only 


Once per- frame 


Worst Case; 61 cycles 
(Worst case means that 
RLilOOE or LRJ100E is to be 
called because character 
boundary was crossed.) 


RLMOVE. Best Case; 1,113 cycles 

Worst Case;- 20,733 cycles 
LRMOVE Best Case; 1 , 113 . cycles 

Worst Case; 28,733 cycles 


Every 8 th bit move 


Every Gth bit move 


RASTWT Always; 126 r 


Once every l/60th. sec.. 


126 cycles 


EXAMPLE 



the speed and direction of the text in the center. 


1000 ; 

1010 ; x-****-*^-***^*** * x - :( ■ * **• 

1020 ;•* EXAMPLE OF THE 
1030 }* SMOOTH SCROLL ROUTINE 
1040 ;* UGE3 JOYSTICK 
1050 ; 

1060 ? 

1070 DECLARE THESE VARIABLES X- 
1000 x -=*0002 for somewhere in pase z»ro 
1090 SPEED *=*+1 
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1100 

1110 

1120 

1130 

1140 

1150 

1160 

1170 

1180 

1181 

1190 

1200 

1210 

1220 

1230 

1240 

1250 

1251 

1252 


SCRNLO *=*+2 
SCRNHI *=*-+2 
COLRLO *=*+2 
COLRHI *=*4-2 
DELAY1 *=*4-1 
XPMOV *=*-H 
FLAG1 *=-(4-1 
COLUMN *=*-H 
COUNT *=* 4-1 
;******* THESE 
CIAICR =$OCOD 


ARE STANDARD MAX DECLARE VARIABLES ******* 


RASTER 
VICIRQ 
SCROLX 
IRQMSK 
CIACRA 
CIAPRA 
;****** 


ROWS =$09 


=$0012 
=■50019 
=50016 
=$DQ1A 
=$DCOE 
=$0C00 
THESE 


ARE CONSTANTS ****** 


1253 

HIBYTS =$05 


125-4 

HIBYTC =W9 


1255 

LOBYT =$60 


1256 

XEOR =$40 


1257 

TOP =$82 


1260 

*=$2000 


1270 

SAMPLE LDX 

HO f 

1200 

P0C5 LDA 

H32 ? 

1290 

STA 

$0400,X 

1300 

STA 

$04004-256 ,X 

1310 

STA 

$04004-512,X 

1320 

STA 

$04004-768 ,X 

1330 

LDA 

HOI 

1340 

STA 

$0800,X 

1350 

STA 

$08004-256, X 

1360 

STA 

$0 0 004-5 1 2, X 

1370 

STA 

$08004-768, X 

1300 

DEX 


1390 

BNE 

P0C5 

1400 

LDY 

#16 fl 

1410 

NXTLIN LDA 

LINE1,Y 

1420 

ST A 

$0470*10,Y 

1430 

LDA 

LINE2,Y 

1440 

STA 

$04C0+10,Y 

1450 

LDA 

LINE3,Y 

1460 

STA 

$07204-10,Y 

1470 

LDA 

LINE4,Y 

1480 

STA 

$0770*10,Y 

1490 

LDA 

LINES,Y 

1500 

STA 

$0563*10,Y 

1510 

LDA 

LINE6,Y 

1520 

STA 

$06AQ*10,Y 

1530 

DEY 


1540 

1550 

1560 

1570 

8PL 

NXTLIN 

JSR 

LDA 

STA 

SET IRQ 

»$00 f ! 

SPEED 

/15/0 

n 

(C) 


:lear screen/color memory 

3EE APP. NOT 4009 (POWER ON 


CLEAR) 


;PUT UP 


JET INITIAL SPEED 


1902 CoftHivotior 
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iseo 

flAIN JSR 

BiTaov 

1590 

INC 

COUNT 

1600 

LDX 

B$00 

1610 

GNE 

aAIN 

1620 

LDA 

CIAPRA 

1630 

LSR 

A- 

1640 

LSR 

A 

1650 

LSR 

A 

1660 

BCS 

J0YLP1 

1670 

DEX 


1680 

J0YLP1 LSR 

A 

1690 

BCS 

JOYENB 

1700 

INX 


1710 

JOYEND TXA 


1720 

CLC 


1730 

ADC 

SPEED 

1740 

CKP 

&$F7 

1750 

BEQ 

MAIN 

1760 

cap 

H$09 

1770 

BEQ 

aAIN 

1780 

STA 

SPEED 

1790 

jap 

aAIN 

1800 

SETIRQ SEI 


1310 

. LDA 

K$7F 

1820 

STA 

CIAICR 

1330 

LDA- 

CIAICR 

1840 

LDA 

t*$01 

1850 

STA 

IRQaSK 

1860 

LDA 

lt$00 

1370 

STA 

$DCOE 

1880 

STA 

DELAY! 

1390 

STA 

COLUaN 

1900 

LDA 

«$02 

1910 

STA 

RASTER 

1920 

STA 

FLAG1 

1930 

LDA 

tKRASTWT 

1940 

STA 

$314 

1950 

LDA 

H>RASTWT 

1960 

STA 

$315 

1970 

LDA 

tt$CO 

1900 

STA 

xpaov 

1990 

CLI. 


2000 

RTS 


2010 


•r r-f. 

r .trTr -.v-.v Tv tc .r.r.v t 


2020 

euaov LDA 

DELAY 1 

2030 

BEQ 

BITRTS 

2040 

LDA 

B$00 

2050 

STA 

DELAY1 

2060 

LDA 

xpaov 

2070 

CLC 


2080 

2090 

ADC 

SPEED 

2100 

STA 

xpaov 

2110 

TAX 


2120 

AND 

H$oe 

2130 

BEQ 

BITRTS 


f SET JOYSTICK ***SEE APP. NOTE 4003 ***• 


rIF SPEED IS WITHIN RANGE, SAVE IT 


TSELECT RASTER TYPE INTERUPTS 
JZERO OUT VARIABLES 

t RASTER LINE OF TOP OF SCROLL 

;GET THE LSB OF INT&RUPT ROUTINE 
;6ET THE r.SB OF IHTERUFT ROUTINE 
INITIALIZE THE SCROLX LOOKALIKE VAR. 


DELAY 1 ?GET DELAY 1 FLAG ’ *~~~*****«- 

BITRTS ; BRANCH IF RASTER HASP ’ T *.r,r a e.a^c 

—«n ; CLEAR OUT 0ELAY1 FLAG T MA ° C fA S 

;GET THE SCROLX LOOKALIKE 
} ADO THE DISJTANrr t/\ 

'»<•« > x >. < E or TO SCROLL. «U8T « 
J STORE NEW OFFSET * FF ' >= X ' $F3 

?CHECK TO SEE ip Tt 
'BRANCH IF If IIAg,Vt HRAPPED 


( C ) 19 S 2 C o 6i iii o fj q 
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APP NOTE 2002 


SCROLLING 


21 AO 


TXA 



2150 


AND 

ft*07 

)GET THE NEEDED BITS 

2160 


3TA 

XPMOV 

?STORE NEW NUMBER 

2170 


LDA 

HS05 

}HIGH BYTE OF STARTING LINE MINUS 40 

2100 


STA 

SCRNLO-+L 


2190 


STA 

SCRNHI+1 


2200 


LDA 

IMO-9 

?HIGH BYTE OF COLOR RAM 

2210 


STA 

COLRLO+1 


2220 


STA 

COLRHI+1 


2230 


LDA 

ft* 68 

}LOW BYTE OF STARTING LINE MINUS 40 

2240 


STA 

SCRNLO 


2250 


TXA 



2260 


BMI 

RLMOVE 

* IF WRAPPED PASSED ZERO, BRANCH 

2270 


ePL 

LRMOVE 

)OIDN r T WRAP, XPMOV WAG JUST TOO BIG 

2280 

BITRTS 

RTS 



2290 

vU 

i 

| 

LEFT 

TO RIGHT 

MOVE 

2300 

RLMOVE 

LDX 

ft*? 

f ftttttttft- NUMBER OF ROWS ftttttttft 

2310 

RLLP1 

LDY 

ftiFF 

)COLUMN 0 MINUS 1 

2320 


LDA 

SCRNLO 


2330 


CLC. 


JGOTO NEXT ROW 

2340 


AOC 

ft4lT 


2350 


STA 

SCRNLO 


2360 


STA- 

SCRNHI 


2370 


STA 

COLRLO 

- 

2300 


STA- 

coLRtrr 


2390 


BCC 

RLLP2 

;N0 ADJUSTMENT WAS NEEDED, SO BRANCH 

2400 


INC 

SCRNLO*1 


2410 


INC 

SCRNHH-1 


2420 


INC 

COLRLO-:-1 


2430 


INC 

COLRHI+1 


2440 

RLLP2 

INC 

SCRNHI 

) ADJUST FO THE ONE CHARACTER OFFSET IN 

MOVE 




’ 

2450 


INC 

COLRHI 


2460 

RLLP3 

INY 


;GOTO NEXT CHARACTER 

2470 


LDA 

(SCRNHI) r 

Y;GET A CHARACTER 

2480 


STA 

(SCRNLO), 

Y;STORE CHARACTER IN NEW LOCATION 

2490 


LDA 

(COLRHI) r 

Y)GET A COLOR 

2500 


STA 

(COLRLO) , 

Y?STORE COLOR IN NEW LOCATION 

2510 


CP Y 

#39 

;IS ROW DONE? 

2520 


BNE 

RLLP3 

JNOr SO BRANCH 

2530 


DEX 



2540 


BNE 

RLLP1 


2550 


STY 

COLUMN 


2560 


BEQ 

YERPLT 


2570 

; it****-* 

LEFT 

TO RIGHT 

MODE **<**** 

2580 

LRMOVE 

LDX 

f»9 

} ftttttttft- NUMBER OF ROWS ftttttttft 

2590 

LRLP1 

LDY 

H3S 

?COLUMN 38 

2600 


LDA 

SCRNLO 


2610 


CLC 


?GOTO NEXT ROW 

2620 


AOC 

ft 40 


2630 


STA 

SCRNLO 


2640 


STA 

SCRNHI 


2650 


STA 

COLRLO 


0 440 


STA 

COLRHI 


£ Q U u 

0470 


BCC 

LRLP2 

i NO ADJUST NEEDED, SO BRANCH 

2680 


INC 

SCRNLO-:-1 
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APP NOTE 2002 


SCROLL! 


2690 

2700 

2710 

2720 

2730 

2740 

2750 

2760 

2770 

2780 

2790 

2800 

2810 

2020 

2830 

2840 

2850 

2860 

2370 

2880 

2890 

2900 

2.910 

2920 

2930 

294Q 

2950 

2960 

2970 

2980 

2990 

3000 

3010 

3020 

3030 

3040 

3050 

3060 

3070 

3080 

3090 


INC SCRNHH-1 
INC COLRLO-i-1 
INC COLRHI+1 

LRLP2 INC SCRNHI ) ADJUST FOR THE ONE BYTE OFFSET IN MOVF 
INC COLRHI. 

LRLP3 LDA (SCRNLO),YjGET A CHARACTER 

STA (SCRNHI)rYfPUT CHARACTER IN NEW LOCATION 
LOA (COLRLO) r Y ?GET A COLOR 
STA (COLRHI) 7 Y;STORE COLOR IN NEW LOCATION 
DEY ;NEXT ONE? 

BPL LRLP3 
OEX 

BNE LRLP1 
STX COLUMN 

j iKHt-SHfe*-' WRAP CHARACTERS FROM ONE EDGE TO THE OTHER 

YERPLT LD'X #9 . ------ 

LDY COLUMN 


JNO, SO BRANCH 

;GOTO NEXT ROW IF NOT DON! 


NPLP1 


LDA 

S.TA 

LDA 

STA 

LDA 

CLC 

AOC 

STA 

LDA 

AOC 

STA 

TYA 

EOR 

TAY 

LDA 

LDY 

STA 

TAY 

LDA 

LDY 

STA 

OEX 

BNE 

RTS 


#*05 

SCRNLO-H 
It *68 
SCRNLO 
SCRNLO 

#40 

SCRNLO 

SCRNL0+-1 

#0 

SCRNLO+1. 


; NUMBER OF ROWS. 
f HIGH BYTE OF TOP LINE MINUS 40 
;LOW BYTE OF TOP LINE MINUS 40 

;go to next row 

rAJDUST HIGH BYTE IF PAGE WAS CROSSED 


#39 

(SCRNLO)rY 
COLUMN 
(SCRNLO)rY 

(COLRLO) r Y 
COLUMN 
(COLRLO) r Y 


NPLP1 


;D0 IT AGAIN IF NOT DONE 


3100 

;*****•*• RAS 

TER INTEI 

311.0 

RASTWT LDA 

VICIRQ 

3120 

STA 

VICIRQ 

3130 

AND 

#*01 

3140 

BEQ 

RASLP1 

3150 

LDA 

FLAG1 

3160 

EOR 

#*•40 

3190 

STA 

FLAG1 

3200 

STA 

RASTER 

3210 

3220 

CMP 

#*C2 

3230 

BNE 

RASLP1 

3240 

LDA 

XPMOV 

3250 

AND 

H*07 

3260 

ORA 

tt*C0 


RASTER INTERUPT DRIVEN ROUTINE *-****«- 
- ) CLEAR THE IRQ 

rIS IT A RASTER INTERUPT 
; NO r SO BRANCH 


? GET THE RASTER TOGCLE FLAG 
;CALC. NEW RASTER LINE 
;STORE THE NEW STATUS 

;GET THE NEXT RASTER LINE THAT yah hawt 
;AN INTERUPT ON MA f Y0U r 

;##### IS RASTER AT THE BOTTOM -7 
j YES t SO BRANCH ' 

;GET 3CR0LX LOOKALIKE 

;SET OTHER BITS AS REQUIRED 
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APP NOTE 2002 


SCROLLING 


3270 


STA 

SCROLX 

; STORE IT IN THE 

3200 


STA 

OELAYL 

;SET DELAY1 FLAG 

3290 


BUI 

RASLP2 

; ALWAYS 

3300 

RASLP1 

LDA 

H*CO 

;SET SCROLX TO 0 

3310 


STA 

SCROLX 


3320 

RASLP2 

PLA 


PRESET THE STACK 

3330 


TAY 



3340 


PLA 



3350 


TAX 



3360 


PLA 



3370 


RTI 



3380 

r 




3390 

?*** SI 

CREEN 1 

DATA FOR 

EXAMPLE ONLY *** 

3400 

LINE1 

.BYT 

'THIS 

AREA -OOES NOT' 

3410 

LINE2 

.BYT 

r 

MOVE 

3420 

LINE3 

.BYT 

' THIS AREA IS ' 

3430 

LINE4 

.BYT 

' S 

TATIONARY 

3440 

LINE5 

.BYT 

'THIS 

AREA SCROLLS' 

3450 

LINE6 

.BYT 

'WEEE. 

.HERE WE GO!' 

3460 

. END 


. 
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= Joe McEnerney and Eric Cotton 
= Random Number Generator 
i om 3 -fc -=• j-i c4 -=• j— «zJ = NTSC or PRL 


I - Ms “b s This subroutine generates psuedo—random 
numbers by the congruence x<n+l) = <3 + 2tl7> x<n> mocK2T35>. x<8> 
c-*n be any non-zero ualue. The routine will force this seed, value to 
bt 1 odd to insure the maximum period. This routine operates in binary 
*rd th* results will be a 35 bit binary number residing in the most 

°^ «<■ 5 byte -field. The period o-f the sequence is 
C'.p.jo9 / ^o 4,592 and the most significant byte is most random. R time 
based seed can be obtained by calling the routine called 'SEED'. The 
generator is normally seeded once. Subsequent calls to 'RNDNUM' will 
produce t iew random values. Rt RTS time the accumu lator will contain 
Ji*=* most sign if icacnt byte. 


II- 


EXPOSITIOM= 


R. Flow Charts 



B. Program l istings: 
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page i 


























1 000 

• PAGE 

'RANDOM*' 


1010 

• 

r 



1 020 

; **** 

RANDOM NUMBER GENERATOR mm 

1030 

• 

s 



1040 

; CALL 

'SEED' FOR TIME BASED SEED 

1050 

,-<THE 

GENERATOR IS 

: NORMALLY SEEDED ONCE) 

1060 

;SUBSEQUENT CALLS 

TO 'RNDNUM' 

1070 

;WILL 

PRODUCE NEW 

RANDOM VALUES. 

1080 

• 

S 



1090 

#=$0002 

;0R ELSEWHERE ON ZERO PAGE 

1100 

VARIABLES 


1110 

RND 

#=#+5 

;RANDOM NUMBER 

1120 

TMP 

#=#+5 

;TEMPORARY STORAGE 

1130 

m 

r 



1140 

;CONSTANT 


1150 

RASTER 

=$0012 

;VIC REGISTER WITH RASTER LSB'S 

1160 

• 

. 


1170 

*=$0000 

;0R ELSEWHERE 

1180 

• 

r 



1190 

SEED 

LDA RASTER 

;USE RASTER AS A SEED 

1200 

SEED0 

LDX #$04 

,-OR ANY OTHER VALUE IN REG A 

1210 

SEED1 

STA RND,X 

;STORE SEED VALUE IN ALL BYTES 

1220 


DEX 


1230 


BPL SEED1 


1240 

RNDNUM 

LDA #$E0 

;MASK OFF LSB'S AND INSURE 

1250 


AND RND+4 

;THAT UPPER 35 BITS ARE AN 

1260 


ORA #$20 

;0D0 BINARY NUMBER 

1270 


STA RND+4 


1280 


CLC 

;BE SURE DECIMAL MODE IS CLEAR 

1290 


LDX #$04 

;ADD THE ARRAY RND<+8, . . . ,+4> 

1300 

RNUM0 

LDA RND , X 

;T0 RNDC+0,. .. ,+4> AND STORE 

1310 


ADC RND,X 

RESULTS IN TMF'<+0, . . . ,+4) . THIS 

1320 


STA TMP,X 

; MAKES CTMPJ = 2 * CRNDI 

1330 


DEX 

;THIS ACCOUNTS FOR ONE OF THE 17 

1340 


BPL RNUM0 

;REQUIRED LEFT SHIFTS NEEDED LATER. 

1350 


CLC 


1360 


LDX #$04 

; ADD RND<+0,.. . ,+4> TO 

1370 

RNUM1 

LDA RND,X 

;TMP<+0, ... ,+4> AND STORE RESULTS 

1380 


ADC TMP , X 

; IN RND< +0 ,. . . , +4) . THIS MAKE' 1 ' 

1390 


STA - RND , X 

;CRND3 = 3 * C RND D 

1400 


DEX 


1410 


BPL RNUM1 

~ 

1420 


CLC 


1430 


LDX #$02 

;LEFT SHIFT TMP<+0_ , +4 s , 

1440 

RNUM2 

LDA RND,X 

; TIMES AND ADD TO RND<+0 ' lc ' ^ lD I TIuWflL 

1450 


ADC TMP+2 , X 

;THE RESULTS IN RND<+0 P, -'TTING 

1460 


STA RND..X 


1470 


DEX 


1480 


BPL RNIJM2 


1490 


LDA RND 

.sLOAD THE A REG WITH THE MOST pftMnr„ 

1500 


RTS 

;PART OF THE RESULTS. FhNDuM 

1510 

/ 



1520 

.END 
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2. Hex dump <as assembled at $C000> s 


,: 2G00 

fiO 

12 

□ 0 

A2 

04 

95 

02 

Cfi 

10 

FB 

A3 

E0 

25 

06 

09 

.: 2Q10 

5 

06 

13 

R2 

04 

35 

02 

75 

02 

95 

07 

Cfi 

10 

F7 

13 

-: 2820 

©4 

B5 

02 

75 

07 

95 

02 

fcfl 

10 

F7 

18 

fi2 

02 

B5 

02 

.: 2030 

09 

35 

02 

CA 

10 

F7 

35 

02 

30 









_ c * 1 Memory/Register' re-nui rements: The routine requires 57 -C$39) 

.«y •<=*:=• o' memory. Also, 10 bytes -for var i ab les are needed <preferably 

or. zero page). The routine also requires use of the accumulator and 
x register. 


. Worst case execution time is 355 < $ 163) cycles <346.85 

micro-seconds) when initially seeded and 301 <£12D) eye les <2^4.08 
micro-seconds) each time RNDNUM is called. 


E. 

period, 


Limitations: Because the high order byte has the 
1- k is most usef u l when a random byte is needed. 


longest 


F. Initialisation: This random number generator need only be 
seeded once. For a time—based seed call SEED; otherwise load the 
accumulator with an alternate value <0 through 255) and call SEEDQ. 


G. Note: The random number generator on the Sound Inter-Pace 
Device <3ID) may be used as an alternative to the routine presented 
in this Application Note. The SID generator is not adequate tor many 
applications since it will tail the ectui distributive test. Further 
use of voice 3 may be limited. Reter to the 6581 SID chip 
specification tor more information. 


H. Examp le: The following example demonstrates the us.=. + . 

random number generator. Its purpose is to simulate throwi ng 
of dice. Wen executed, hitting the FI function key will roll *• * ^ a ‘* r 
dice and display their values on the top-middle of the Srne 

pushing the F3 function key will cause a break to the ° 

sure the $8090 version of VICMON -XVM4.8- is loaded.) n + * tor • 
first operation of the program is to seed the proem a/n ° * *^" ,e 

LSB's of the raster value. 


with the 8 


The starting address of this example is $C3FiFi 
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1 000 
101 0 
1 020 
1 030 
1040 
1050 
1060 
1 070 
1 080 
1090 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1323 
1330 
1340 
1350 
1363 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 

9/9/8 


. PAGE ' RPR3005EX •' 

• 4444 EXAMPLE OF RANDOM NUMBER GENERATOR 4444 
444 SIMULATE A THROW OF DICE 444 


4—T0002 
;VARIABLES 
RND 4=4+5 

TMP 4=4+5 

•CONSTANTS 
RASTER =$0012 
GETIN =$FFE4 

4=$0000 


EXAM 

JSR 

SEED 

EX0 

•JSR 

GET IN 


CMP 

#133 


BEQ 

EX1 


CMP 

#134 


BNE 

BRK 

EX0 

EX1 

JSR 

EX2 


STA 

$0411 


JSR 

EX2 


STA 

$0413 


JMP 

EX3 

/ 

EX2 

JSR 

RNDNUM 


BEQ 

EX2 


CMP 

#$07 


BCS 

CLC 

EX2 


ADC 

#$30 

r 

RTS 


SEED 

LDA 

RASTER 

SEED© 

LDX 

#4 

SEED1 

STA 

DEX 

RND.X 


BPL 

SEED1 

RNDNUM 

LDA 

#$E0 


AND 

RND+4 


ORA 

#$20 


STA 

CLC 

RND+4 


LDX 

#4 

RNUM0 

LDA 

RND..X 


ADC 

RND , X 


STA 

DEX 

TMP , X 


BPL 

CLC 

RNUM0 


;RANDOM NUMBER 
;TEMPORARY STORAGE ' 


;VIC REGISTER WITH RASTER LSB'S 

;KERNAL ROUTINE: GET A CHAR. FROM KEYBOARD BUFFE! 


;SEED RANDOM NUMBER GENERATOR WITH RASTER VALUE 
;SEE IF A KEY WAS PRESSED 
;WAS IT THE 'FI' KEY? 

}IF SO THEN BRANCH TO 'THROW' THE DICE 
;WAS IT THE 'F3' KEY? 

}IF NOT THEN CHECK KEYS AGAIN 
; ELSE BREAK 

;ROLL THE FIRST 'DIE'... 

;...AND PUT ITS VALUE ON THE SCREEN 
;ROLL THE SECOND 'DIE'... 

;...AND PUT IT ON THE SCREEN 


;GET A RANDOM NUMBER 

;IF IT IS A 0 THEN GO BACK AND TRY AGATN 
;IF IT IS GREATER THAN 6 THEN 
GO BACK AND TRY AGAIN' 

; ADD OFFSET TO GET APPROPRIATE SCREEN VALUE 


;USE RASTER AS A SEED 

;0R ANY OTHER VALUE IN REG A 

;STORE SEED VALUE IN ALL BYTES 


;MASK OFF LSB'S AND INSURE 
;THAT UPPER 35 BITS IS AN 
•ODD BINARY NUMBER 


;ADD THE ARRHY RND<+0„ + ' 

;TO RND C +0,...,+4 > AND STOPc * 

; RESULTS IN TMPC+0,. 

:MAKES CTMP3 = 2 4 CRhC,] '* HIS 
• THIS ACCOUNTS FOR ONE r, F T HF i- 
;REQUIRED LEFT SHIFTS N^DeS LATER. 


Commodore 







1560 

LDX 

#4 

;ADD RND<+©,...,+4> 

TO 

1570 RNUM1 

LDR 

RND , X 

;TMP<+0,...,+4> RND 

STORE RESULTS * 

1530 

RDC 

TMP , X 

IN RND '■! +0+4 > . 

THIS MAKES 

1530 

STR 

RND.. X 

;C RND] = 3 * C RNDI 


1600 

DEX 




1610 

BPL 

RNUM1 



1620 

CLC 




1630 

LDX 

#2 

;LEFT SHIFT Tt1P<+0,. 

..,+4> 16 ADDITIONAL 


165© 

1660 
1670 
1680 
1690 
1700 
1710 ; 
1720 .END 


LDR RHO , X 
RDC TMP+2,X 
STR RND,X 
□EX 

BPL RNUM2 
LDR RND 
RTS 


TIMES RND RDD TO RNDC+0,. . . ,+4> PUTTING 
;THE RESULTS IN RNDC+0,...,+4> . 


;LORD THE R REG WITH THE MOST RANDOM 
jPRRT OF THE RESULTS. 
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* i• i"”' s Bill Hindortt & Joe McEnerney 
, - J -J = Keyboard Scanning routine 

T >==- 1 •=••...« ± :=: ± .=.t--, S-^.=«j-mz4.=.^-c 4 = NTSC or PRL 

*"“*^ z "^*■""-=•-■— “t: s This routine reads and decodes keyboard date. -from 
Ports R ($OC@0> end B <$DC01> ot CIR #1 CMOS 6526 chip}. It is not 
designed to be celled more then once rer l/69th ot a seconds end as 
e. resu 11is me 11 sui ted to ah IRQ routine. R key on the me.tr ix 
mhi'-fi i^. held down tor more then he.lt e. second mi 11 auto—repeat. 

Upon return trom the subroutine^ the -accumulator end a memory 
^--t in de+ined by the oeriab le UKEV m.ii 11 he.oe been set to the ro*.u 
=*/id *— lurnn ot the current key pressed. The upper tour bits contain 
the row end the lower tour bits contain the column. The carry is 
-^either no new key has been pressed, or a. key has not been 
held down tor halt a second. 

EEI >=: •“•:=: ± -fr. ± >— • r--, 5 

c 

•=0* F low ch-ar-t: 


KB'D 


JSR KEVSCH 


CMP #*FF 


<BEQ KBD1^> 


CMP OKEV 


<BNE KBPS 



Ikbdo 


—jKBOI 

KEVSC 


DEC KTIM 
<BNE KBO 


H 


ST ft 

OKEV 

LDX 

#S1 

STX 

KTIM 

CLC 


RTS 


LOR 

“S’FF 

STR 

Pfi 

CMP 

PB 


►KSO 


r>KSl 



LDfi 

#9 

STft 

PR 

LDft 

#*FF 

CMP 

PB 

<^BEQ 

kou7^> 

LDX 

#7 

LDV 

#7 

LDft 

KSTBL.-X 

STft 

Pft 

LDft 

PB 

CMP 

KSTBL..V 


tPEV I 



1DEX 



I 1" ro to,-, J ^ 0 


(5) 








































TXfi 

RTS 

TXA 

ASL 

R 

RSL 

R 

ASL 

R 

RSL 

A 

STV 

TV 

ORfi 

TV 

RTS 

—J 


to) Die.*irejivs : The to 1 lowing dia.*irem i 1 lustre.tes the U 
fue.trix e^socie.ted with the Commodore 64 end the Mex. 


eyb'jerd 


R 


B < $0C 31 > 


0 


P 

o 

R 

T 

R 


3 — 

DEL 

RET 

CSR 

ROT 

F7 

FI 

F3 

F3 

CSR 

ON 



w 

R 

4 

z 


E 

L 

SFT 

L 

% 

5 

R 

0 

s 

c 

F 

T 

x 


i** 

V 

G 


e 

H 

IJ 

l tt l 


Q 

I 

J 

0 

M 

K 

0 

N 


+ 

P 

L 

- 

- 

1 •’ 

Id 



L 

* 

; 

HOME 

R 

SFT 

= 

t 



1 

- 

CTRL 

o 

u 

SRC 

& 

Q 

STOP 











Program li^tirn< 


essemb led 


■*C8@0 


Com fi'iodon* 








































listing 


1 > 


Source 


1000 .PAGE KBD 7/13REV 

1002 Pft-f-OCOO 

1003 PB=iOCO1 

1004 *=$62 
100i5 OKEV :♦:=*+1 
100? KTIM *=*+1 
1003 TV '+:=:++1 
1003 jf:=$C200 

1013 KBD JSR KE’t'SCN 


102O 
1030 
1040 
105O 
1030 , 

1070 

1030 KBDO 
103O 
1100 
1110 

1120 KBD1 
1130 KEVSCW 
1140 ' 

1150 
1160 
1170 
1 ISO 
1130 
12O0 
1210 
_ 1220 
* 1230 
1240 

1250 KSO 
1260 
1270 

1230 KS1 
1230 
1 300 
1310 
1320 
1330 
1340 
1350 

1350 KOUT 
1370 KS2 
1330 
1330 
1 400 
1410 
1420 
1 430 
1440 


CMP #$FF 
BEQ KBD1 
CMP OKEV 
BNE KBDO 
DEC KTIM 
BNE KBD1 
3TA OKEV 
LDX #31 

stx ktim 

CLC 

RTS 

LDfl #$FF 
STft PR 
CMP PB 
BNE KOUT 
CMP PR 
BNE KOUT 
LDR #0 
STft Pft 
LDR #$FF 
CMP PB 
BEQ KOUT 
LDX #7 
LDV #7 
LDR KSTBL.-X 
STft PR 
LDfl PB 
CMP KSTBL.-V 
BEQ KS2 
DEV 

BPL KS1 
DEX 

BPL KSO 
TXA 
RTS 
TXA 
RSL R 
RSL ft 
RSL R 
RSL R 
STV TV 
OPR TV 
RTS 


THIS ROUTINE HANDLES AUTO REPEAT 
,:0F KEVS HELD DOWN FOR MORE THAN 
;.5 SECONDS. IT SHOULD NOT BE CALLED 
;MORE THAN ONCE PER 60TH OF R SECOND. 
;A COUNTER KTIM COUNTS FRAMES 
< 1/60THS OF R SECOND >. OKEV SHOULD 
;BE SET TO TFF PRIOR TO FIRST USE. 

THE USER SHOULD TAKE CARE TO PREVENT 
;MULTIPLE KEV DETECTION BV CALLING 
.1 KBD ONLV ONCE PER FRAME. THIS WILL 
RESOLVE KEV BOUNCE PROBLEMS. 

;A VALID KEV HAS BEEN RECEIVED IF 
;THE CARRV IS ZERO <C=0> UPON RETURN. 


;BUTTON B OR JOVSTICK B <CO0E-$FF> 
;BUTTON A OR JOVSTICK R <CODE-$FF> 


;NO KEV DEPRESSED (CODE—$FF> 
;MRIN SCANNIHO RL GORITHM 


KSTBL IS AN AUXILIARV TABLE 
;OF 3 B'r'TES EACH HAVING ONLV 
’ONE ZERO BIT. EACH B'tTE IS 
USED TO ENABLE ft KEV MATRIX ROW 
AND LOOK FOR fl KEV DOWN ON R 
;COLUMN BASIS. THE COMBINATION 
.-•PRODUCES 64 ROW/COLUMH INTER- ~ 
.-•SECTIONS THAT CORRESPOND TO 
,:THE PHVSICRL KEYBOARD. 

:N0 LEGAL KEV FOUND DURING orAH 
: CCODE-TFF) “ ‘ n 


; THE ROM HljrieEP 'x-: « D T,,.r H - 

;HUHBER <V> sno prcdu! 

.?UUOE IN THE ACCUMIHATOD r'r- L EtTc 
.: SIGNIFI CANT N VBBL E~rl or r ' HE MU * T 
,:Ic' THE RuW NUMBER AND rnr , PS .-. T 
.:SIGNIFICANT NVBF'LFt- LEH:T 
-•NUMBER ~ LE Ic ' THE COLUMN 


L'o rnrricido 


K 






. BYTE $FE,$F0,*FB,*F7,*EF,$OF,$BF,:S7F 


1450 KSTBL 
1460 .END 


2> Hex Dump: 


. : 

2200 

20 

17 

L-c- 

09 

FF 

F@ 

0F 

C5 

62 

D0 

04 

C6 

63 

DC 

07 

35 

. : 

2210 

62 

R2 

IF 

36 

63 

IS 

6G 

RS 

FF 

3D 

00 

DC 

CD 

01 

DC 

00 

. : 

2220 

2R 

CD 

00 

DC 

D0 

25 

R3 

00 

3D 

00 

DC 

R9 

FF 

CD 

01 

DC 

. : 

2230 

F0 

13 

R2 

07 

R0 

87 

BD 

56 

C2 

SO 

00 

DC 

RD 

01 

DC 

09 

. : 

2240 

56 

C2 

F0 

03 

33 

10 

F5 

Cfl 

10 

ER 

Sfi 

60 

SR 

0R 

0fl 

0R 

. : 

2250 

0R 

34 

64 

05 

64 

£0 

FE 

FD 

FB 

F7 

EF 

DF 

BF 

7F 

00 

00 


3> Data Statements: 


DATA 

DATA 

DATA 

DATA 

DRTR 

DRTR 

DRTR 


32 ,23,134, 201, 255, 240,15,137,33,203,4,193,99 , 203 
7,133,33,162,31,134,33,24,36,169,255,141,0.220,205 
1,220,203,42,205,0,220,203,37,169,0,141,0,220 169* 
255,205,1,220,24©,25,162,7,160,7,1 sgi,ftp.’ \ 04" j ^ ''~ Tl 
220,173,1,220,217,36,194,240,3,136,16*245* 9fl-> 16 * 
234, 133,36, 133, 10, 10,10,10,132, 100 .5,1 && *’0^*4'' 
253,251,247,233,223,191,127 


cO Memory/Re*iistar re-:iuirements : This routine re^iuir 94 
fS5E> bytes o-f' memory. It uses the accumulator, X, .s, nd y j _. _ 
and 3 bytes o't storage. ' ' 


e> Worst case execution time is 1135 cycles for 1161.30 
on a 1.02 MHz system}. 


jusacs 


f> Limitations: R valid key has been.pressed if 5r , d , . , 

the carry is clear upon returnin'?. otherwise, the data. in"+>-^ 
accumulator and OKEV should be ignored. The routine can rmf. 
determine it the keyboard or .joystick pair caused a. keypr^r- 

^ * 3 } Prior to us i n*i this subroutine, UkEV should be ini ti => li^^d 


h> Example: 


T h i s .=. x p. 1 ■=. m i aits 
d 1 — - P lavs the row and co lumn 


for a valid key f,-, u,_ 

ot the key pressed' *' * th * n 


1000 .PAGE EXAMPLE 
1010 PA-f0000 




1020 CHROUT=$FF 02 
1000 PB=$ 0 C 01 
1040 *=$62 
1050 OKEV :+:=:*+1 
1060 KTIM *=.*+1 
1070 TV *:=.*+l 
1000 
1090 


1 1 00 
1110 
1 1 20 

*=$C200 

SEi 

LDA 

#<KBO 

SET UP AN IRQ VECTOR 

1130 

STR 

$0314 

;TO THE KEYBOARD EXAMPLE 

1 140 

LDA 

#>KBO 


1150 

STR 

$0315 


1160 

LDR 

#$FF 

;INITIALIZE OKEV 

11 70 

STR 

OKEV 


1130 

1 200 

CL I 

KEVCK LDA 

TV 

;IF TV IS NON-ZERO. 

1210 

1220 

BNE 

KEVCK 

;THEN THERE IS NO 

LDA 

OKEV 

;VALID KEV 

1230 

AND 

#$F0 


1240 

LSR 

R 


1250 

LSR 

fl 


1260 

LSR 

R 


1270 

LSR 

R 


1230 

ORA 

#$30 


1230 

STR 

$0413 

}PUT THE ROW # TO 

1 300 

LDA 

OKEV 

THE SCREEN 

1310 

AND 

#$0F 


1320 

ORA 

#$30 


1330 

STR 

$0414 

;PUT THE COLUMN TO SCREEN 

1340 

JMP 

KEVCK 

:00 AND DO IT AGAIN 

1350 


1360 

;**************$***$******$*********:*$ 

1370 

.PAGE KBO 

S/27REV 


1330 

KBOI LDR 

#$FF 

;INITIALIZE OKEV 

1390 

STR 

OKEV 



1400 KBO 
1410 
1420 
1430 
1440 
1450 
1460 

1470 KBOO 
1400 
1 490 
15 

1510 KBO 1 


CMP #$FF 
BEQ KBO 1 
CMP OKEV 
EWE KBOO 
DEC KTIM 
ONE KBO 1 
OTR OKEV 
LDX #31 
STK KTIM 
CLC 

LOR #$00 


;THIS ROUTINE HRNOLES RIJTO REPERT 
.: OF KEVS HELO DOWN FOR MORE THRN 
•.5 SECONDS. IT SHOULD NOT BE CALLED 
;MORE THRN ONCE PER 1 / 60 TH OF R SECOND 
,:R COUNTER KTIM IS USED TO COUNT FRRME 
; ■:! 1 / 60 THS OF R SECONO. OKEV SHOULD 
;BE SET TO $FF PRIOR TO FIRST use' 

; THE USER SHOULD TAKE CARE TO PRFVfwt 
;MULTIPLE KEV DETECTION BV CALLINC 
:KBD OWLV ONCE PER FRAME. THIS it, , 
RESOLVE KEV BOUNCE PROBLEMS " * 


1520 

ROR R 


1530 

STR TV 

PUT THE CARRY IN TV 

1540 

LDR $DCOD 

;CLEAR THE 6526 INTERRUPTS 

1550 

PL A 


1560 

TRV 


i S 70 

PLA 

RESTORE R, /, RND V 


. i. I* f ' 


L‘ornrrioi;i, :ir . e 




1570 


PLfi 


1580 


TAX 


1590 


PLfi 


1 600 


RTI 


1610 

KEVSCN 

LDA 

#SFF 

1620 


STA 

PA 

1630 


CMP 

F'B 

1640 


BNE 

KOUT 

1650 


CMP 

PA 

1660 


BNE 

KOUT 

1670 


LDA 

#0 

1680 


STA 

PA 

1690 


LDA 

#*FF 

1 700 


CMP 

PB 

1710 


BEQ 

KOUT 

1720 


LDX 

#7 

1730 

KSO 

LDY 

#7 

1740 


LDA 

KSTBL 

1750 


STA 

PA 

1760 

KS1 

LDA 

PB 

1770 


CMP 

KSTBL 

1780 


BEQ 

KS2 

1790 


DEV 


1 808 


BPL 

KS1 

1810 


DEX 


1820 


BPL 

KSO 

18301 


TXA 


1840 

KOUT 

RTS 


1850 

KS2 

TXA 


1S60 


ASL 

A 

1S70 


ASL 

A 

1880 


ASL 

A 

1890 


ASL 

A 

1 900 


STY 

TV 

1910 


ORA 

TV 

1920 


RTS 


1930 

KSTBL 

.BYTE TFE, 

1940 

. END 




: RESTORE fi.- X, AND V 


'fi VfiLID KEY HRS BEEN RECEIVED IF 
! THE CfiRRV IS ZERO 01=0> IJPOH RETURN. 


:BUTTON B OR JOYSTICK B OI-'OOE—TFF> 
:BUTTON fi OR' JOYSTICK fi <CODE—$FF> 


NO KEY DEPRESSED OHODE-TFF) 

;MfiIN SCANNING ALGORITHM 

;KSTBL. IS AN AUXILIARY TABLE 
OF S BYTES EACH HAVING ONLY 
;ONE ZERO BIT. EACH BYTE IS 
;USED TO ENABLE fi KEY MATRIX ROW 
;AND LOOK FOR fi KEY DOWN ON fi 
COLUMN BASIS. THE COMBINATION 
;PRODUCES 64 ROW/COLUMN INTER¬ 
SECTIONS THAT CORRESPOND TO 
;THE PHYSICAL KEYBOARD 
NO LEGAL KEY FOUND DURING SCAN 
. .:;C0DE-f FF>. 

THIS PART OF THE ROUTINE TAKES 
THE ROW NUMBER <X> AND THE COLUMN 
NUMBER <Y> AND PRODUCES fi ONE BYTE 
;CODE IN THE ACCUMULATOR. THE MOST 
SIGNIFICANT NYBBLE OF THE ACCUMULATOR 
;IS THE ROW NUMBER AND THE LEAST 
SIGNIFICANT NYBBLE IS THE COLUMN 
NUMBER 

i r *FB r *F7 r *EF.. $DFTBF r ■$ 7F 


: = : FTWfl F: E Fl F- F* 1_ X' O RTIO M 

M GTE -R- Ei Ei EL - 


* * 1 —■' " - Eii 11- H i ncJof 'f'f .Si .Joe f■ 1 c E n e r n e y 

= Analog Joystick.-'Four Paddle Read 
i •r*i S~t-=*J- - ic4-=«j-“-.z4 z NTSC or F'RL 


i_-i fcz< .j .=■ i— -t: 


T"•=- !•=•< 


. . ^ r . Tri _= _ s routine reads and decodes the raddle data. 

...c!* _*' ''l' 0 .. “'T *nd reads the tire button data from 

f ' " i i~ ' d , '! + ^ * ' ^'-'S S5£€ ch i p >. The standard entry point 

* +. !. r +u'- *'}! " H ’ : ' ur f ;' -a£,cn * s < equivalent to two analog .joysticks;- and 
"AT v-5-lues: * I ' fc *i^o reads ports ft <$DCQ9> and B <TOCS1 > and 

snrSw-Jn--+*+?- Bi * s two <2> - r " :i ^ree <3> ot TOCO© and 

... ri*p !”~ + . "t °t raddle tire buttons attached to ports fl 

, i ;* ly * + M .*K oncl point, which reads paddles 

tu M ' l * *”«®ed provided the X register is 

-vnditivried t '*' 2 - f "° b*+ore the routine is called. 

E f=• -=: iti ci.i—i z 

ay F low chart < 


PDLRD 

PDLRO0 



M - 0 


N£ 0 


LDX 

#1 

BE I 

LOR 

■CI DORR 

STR 

BUFFER 

LOR 


STR 

ClDORR 

LOR 

***© 

STR 

PORT fl 

LBV 

#*80 

HOP 

DEV 

4 

P0LR02> 

LOR 

SI 0+2? 

STR 

PDLX.X 

LOR 

SI0+2S 

STR 

POLY.X 

LOR 

PORT ft 

I S ft 

#TS0 

STfi 

BTNfi 

LOR 

#S 40 

DEy. 

'3PL 

\ 

P0LR01> 


1 


LOR 

BUFFER 

STR 

ClDORR 

LOR 

PORTft+1 

STR 

BTNB 

CL I 

RTS 




*-• •*-* T;*i f;*# «:«i*4 1—f f.-- ^ 
















































bDie.*ir *i(iJ : The to 1 lowing die.*irem i l lustre.tes the bit r-t 
»c i at e d yj i t h r ad d 1 e t i r e b ».«.* 11 o 1 *i r-. 


Port ft C^DC©0> and/or Port B <^DC0l) 
3 2 1 0 * 

!Butn V!Butn H ! none ! none ! 


i;• Program listing -as -assembled at TCO0O 


1> Assemb \y: 


1000 

1010 ;* FOUR PADDLE 
1020 

1030 ;AUTHOR - BILL 
1040 PORTfl=SDC00 
1050 CIODRft=SDC02 
1060 SI D=*TD400 
1070 £=$C100. 

1030 BUFFER *=*+1 
1090 PQLX *=*+2 
110© PDLV t=t+2 
1110 BTNA t=£+l 
1120 BTNB *=*•+■ 1 


READ ROUTINE <CAN ALSO BE U 
HINDORFF 


BED FOR TWO> 
************* 


1130 

£=$0000 


1140 

PDLRD 



1 150 

,r ldx 

#1 

FOR F 

1 160 

POLRD0 


;ENTRV 

1 170 

SEI 


; TO Z 

1130 

LOR 

ClDORR 

.-•GET Cl 

1190 

STR 

BUFFER 

; SR VE 

1 200 

LOR 

#fOO 


1210 

STR 

CIDDRR 

; SET P 

1220 

LDR 

#‘f SO 


1230 

PDLRD1 



1240 

STR 

PORTfl 

ADORE: 

1250 

LDV 

#$80 

Wfi IT i 

1260 

PDLRD2 



1270 

HOP 



1230 

DEV 



1290 

•—*. w L 

PDLRD2 


1 300 

LDR 

SID+25 

: GET X 

1310 

STR 

PDLX 


1 320 

LDR 

SID+26 

: GET V 

i 750 

STR 

POLS'. :•••: 


1340 

LDR 

PORTR 

:TIME ' 

1350 

ORR 

#f SO 

;MRKE : 

1 360 

STR 

E'TNfi 

.-BIT 2 


FOR FOUR PRDDLES OR TWO RNRLOR Tov - T T ,-k 
entrv point FOR ONE PR IR ■CCONDlfinN •• 

TO ZERO FIRST... X=0> 1 1UN 


SET PORT R FOR INPUT 


POL 


Uorftft’iodore 




j- mr* C. . - - • 














PAIRS DOME? 


1 370 

LDfi #S40 


13S0 

DEX 

;ALi PAIRS DOME? 

i 390 

BPL FDLRD1 

: NO 

1 400 

LDR BUFFER 


1416 

STR ClDORR 

;RESTORE PREVIOUS VALUE OF DDR 

1420 

LDR PORTA+1 

; FOR 2ND PRIR - 

1 430 

STR BTHB 

jBIT 2 IS PDL X, BIT 3 IS POL V 

1440 

CL I 

1450 

RTS 


1460 

. END 



Hex Dump: 


0 

i ■ 

C000 

A2 

01 

r’ 

AD 

02 

DC 

3D 

00 

Cl 

AS 

C0 

3D 

02 

DC R3 

30 

• 

a a 

CV i 0 

3D 

00 

DC 

A0 

SO 

ER 

yj*! 

19 

FC 

AD 

13 

D4 

3D 

01 Cl 

AD 

• 

a a 

0020 

1A 

D4 

3D 

03 

Cl 

RD 

00 

DC 

09 

80 

3D 

05 

Cl 

R9 49 

CA 

• : 

2030 

1 0 

DE 

RD 

00 

Cl 

3D 

02 

DC 

RD 

01 

DC 

3D 

96 

C1 53 

60 


Data Statements: 

DRTft 162., 1 , 12 © , 173,2,226,141 , 0 , 193,1 69 , 192,141,2,229,1 69 
DRTR 123,141,0,220,1 66 ,123,234,136,16,252,173,25,212,157 
C'RTR 1,193 , 173,26,212,157,3 , 133 , 173:, 0,220,3,123,141 ,5,192 
C'RTR 163,64,202 , 16,222 , 173,6,133,141,2,220,173.1 ,220,141 
DRTR 6,1 53 ,3©,*£ 

d , 1 Memory .•••'Re'>i i ster requirements: This rout ins requires 63 
ToF,' bytes ot memory. It uses the e.c.cumu le.tov , X, .and V r >=-.t’ -rtr 
end 7 bytes ot storage. 


e> Worst case e 
JU- *' 1 -- on =•• 1.02 MHz 


xecut i on “h i rri*£ 
system.:*. 


ir 1?97 


-’• # c 1 es or 1 S 63 


+ • Lirni tatioris s This routine will not condi tion . the turn i v .+ 
which contain reddle tire button data. The button combineti 
produce date, as to 1 lows : l ~' 


BUTTONS PUSHED 


HEX VALUE DECIMAL VALUE 


NONE 

SFF 

PADDLE X 

TFE 

PADDLE V 

TF7 

BOTH 

f F2 



>Z' 'Z'£- 


L ommodor» 


ray 









«> p --io r to us in* this subroutine tor r. single pair ct p e.dri U 
be sure you have conditioned the x register to e. zero 

h .* Exe/nr le : The ■followin'? BASIC rro^ireri'j POKES the raddle 
reeding subroutine into memory stent in*T e.t location 49132 tr.nnn •. 
It then calls the subroutine end di sr 1 eyr the reddle date on th-- ' 
screen• 


10 0=12*4036:REM SET PADDLE ROUTINE START 

11 REM POKE IN THE PADDLE READIHO ROUTINE 
15 FORI-0T062:READA:POKED*I,A:NEXT 

20 SVSCiREM CALL THE PADDLE ROUTINE 
30 P1 =F'EEK ■: C+257> : REM SET PADDLE ONE VALUE 
40 P2=PEEK < C+25S >:REM " " TWO 

50 P3 - PEEK<C+253>:REM " " THREE " 

50 F'^r-PEEK <C+2S0 > : REM " " FOUR 

51 REM READ FIRE BUTTON STATUS 

52 S1 =F'EEK < C+261 > :S2=PEEKO:+2S2> 

70 F'RINTF' 1 ,F'2,P3, P4 :REM PRINT PADDLE VALUES 
72 REM PRINT FIRE BUTTON VALUES 
75 PRINT .-PRINT"tire a " ;S1.. "tire b " :S2 
SO F0RW=1T050:NEXT:REM WAIT A WHILE 
SO PRINT"S":PRINT:GOTO 20:REM CLEAR THE SCREEN 
35 REM DATA FOR MACHINE CODE ROUTINE 
10O DATA162.1.120,173.2.220,141,0.1S3,1 S3,1 32 ,1 
11O DATA12S,141,0,220,1SO,12S,234,13S,1S,252,1 7 
120 DATA1,1 S3,173,26,212,157,3,193,78,O,220,202 
130 DATAO,133,141,2,220,173,O,22@,141,5,133,173 
140 DATAS,193.S3.36 
READV. 


AND DO AGAIN 


41,2,22 
3,25,21 
/lb,232 
- 1 , 220 , 


0,1 S3 
2,157 
,173 
141 


Commodore 


r>*** 4 





SOFTWARE FtF'F'L- I CRT I OH 
h--| i~i l i— 0 0 


FH i-j“b•—ir—- z Bill Hindorff 

Subj •=-•- -b = Oi*ii te.1 Joystick Read 

T e=- !*=••.-• ± :=- ± •—«r“i S-b.=.j-ic4.Sij— .i4 = NTSC or PRL 

Fftr«.=:-b r— -=•-•— -b = This routine reads end decodes the 
jovstick/firebutton de.te. es *iiven in the accumulator. The 
e.ccumu let or is assumed to he e. value from port R or port B ot CIR 
#1. The routine will set two ver i eh les, Dft end OV .* which represent 
"he two's complement direction vector. I.E. SFF = -1, SCO = 0 f end 
■^01 = 1. Upon returning, the cerry reflects whether or not the fire 
button is heing pressed. Cerry set \c = 13* means the button was not 
pushed r cerry c leer <c = @> means the button has been pushed. 

El :=< *■=• :=•- ± “b ± *s« f-1 s 


a..- 1 F low chert 


DJRR 

DJRRB 


C»1 


’ D.JR9 

c »1 


^ D JR 1 

C 


IiTRS 


! HP 

snr.ru? 

LDV 

#0 

LDK 

#0 

LSR 

R 

<BCS 

djrJ> 

DEV 

LSR 

R 

<BCS 

d..trJ> 

INV 

LSR 

R 


DJR^> 

DEX 

LSR 

R 



I NX 

LSR 

Ci 

C TV:; 

D v : - 

STV 

DV 




commodore 



pe.*:ie i 






























b> Diern-r : The -fo 1 lowing di scsr-sm i’ l Icrtr s-ter 
'.■'allies end which bits they nennesent. 


:+ i cl 




Fire Button 
Bit ‘1 

Bits 0 i, 

Bit 2 - 

Bits 1 .& ; 


<Tor> 

Bit 0 


wy 


Bits 


/ |\ 


Bits 


Bit 1 


y 


1 



Bit 3 
,<• 


c> Prcjirsjvi listin'? 
1 > Asserrib ly 


sssemb led e.t £C2Si0i 


1 000 
1 0 1 0 
1 0120 
1 01.00 
1040 
1 050 
1060 
1070 
1 0100 
1 090 
1 1 010 
1110 
1 120 
1 130 
1140 
1150 
1160 
1 170 
1 1S0 
1130 
1 2010 
12101 
1220 
1230 
1240 
1250 
1260 
1270 
1230 
1230 


.PAGE <JOYSTICK.S/55 JO VST ICK - BUTTON READ ROUTINE 
AUTHOR - BILL HINBORFF 


DX=£C110 
DV~.SC 111 
$=•£02010 

D-JRR LDFl £DO00 
0.JRRB LDV #0 
LDX #0 
LSR R 
BOS DJR01 
DEV 
LSR R 
BOS 0JR1 
IH V 
LSR R 
BOS D-JR2 
DEX 
LSR R 
BOS D..TR3 
I NX 
LSR R 
STX DX 
STV DV 


D.JR0 

D.JR1 

D.JR2 

D.JR3 


<ENTRY POINT FOR PORT R ONLY:- 
THIS ROUTINE RERDS RMD DECODES TH r 
JOVSTI OK/FI REBUTTON INPUT DATA in" 

THE ACCUMULATOR. THE LEAST SIGNIFICANT 
5 BITS CONTAIN THE SWITCH CL031 IRE 
INFORMATION. IF R SWITCH IS CLOSED THEM tt 
PRODUCES R ZERO BIT. AN OPEN SWITCH 
PRODUCES R ONE BIT. THE JOVSTICK DTP- 
EOT IONS ARE RIGHT., LEFT., FORWARD PRCKUPPri 
BI T3=R IGHT , BI T2=LEFT . BIT1 =p 2™:, Jj? LkWHRD 



<N0 
<MOVE 
ORWARD 


CHANGE 5. DV=-1 ,■ 
DuWN SCREEN :■ , Q 1 ..'—,-. 
JOVSTI CK ' 


left: 

E UP SCREEN>, 

c no v change: 


•AT RTS TIME THE C 
: IF 0=1 THEN BUTTi 
. END 


the FORWARD JOYSTICK PnciTtnn -- T - 

TO MOVE UP the SCREEN g^f**®* 

POSITION T'J MUVt DOWN SCRt~N~ -'H-kWh.-w 

CARRY FLAG CONTAINS Tycr - T __ _ 

w NOT pressed. :f 
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2> He; Dump: 


• : 02 OO R2 OO RO full RD 00 DC 4R BO 

• : C219 BO 01 Cfl 4R BO 01 E8 4R 8E 


01 88 4R 
10 Cl 8C 


BO 01 
11 Cl 


C8 4R. 
60 80 


-■ •' D a.t a, 8 t at e me nt s : 


OfiTfi 

DRTR 


162,0 , 160,0, 172,0,220, 74,176,1,126,74 
176,1,202,74,176,1,222,74,142,16,183, 


,176,1,200,74 
140,17,183,86 


•J.-' Memory/Register requirements: The routine uses 31 <! $ 1F> 
oytes ot memory as well as 2 bytes ot storage. It also uses the 
accumulator, X, and V registers. 


C»tt r. 


•a.' Worst case execution time 
1.02 MHz system!'. 


is 4:3 -CS30} cycles (or- 47.04 usees 


. limitations: This routine assumes that the data direction 
registers have been properly set to read digital joysticks attached 
Hor,.h and.-or port B. The C64 does initialize the ODR-’s prnper 
uron power-up to 255 -(in SDC02> and 0 -'in SDC03>. It the DDR's are 
no.- proper ly set, then the routine will not yield accurate results. 


*•' F ' r V : ' r to using this subroutine, be sure that the accumulator 
holds the joystick reading and that the X and V registers have been 
Rise- see section t•' above. 


h.-- Example: The to l lowing BRSIC program rokes the joystick 
subroutine into memory starting at location 48664 -!SC200>. It t l *--=■ 
^ ^he subroutine and displays the joystick data. The on K- 
ditterence between the example's routine and the assemb ly li•- + i f - 
that the tire button state has been stored at location SC 11c~ 


10 

20 

30 

40 

50 

70 

30 

80 

84 

86 



C=12*4086 

FOR I=0T034:RERDR:POKE1+512+C-R:NEXT 
8VS C+512 

X-PEEK •:! C+272!:- : V=PEEK < C+273 > 

F=PEEKC+274 > 

PRINT" delta x = ":X,"de*.-a v = " :V 
IF F=1 THEM PRINT"tire" 

PRINT'S" : GOT Hi 30 

DRTR 162.0.160,0,173 .0.220,74,176,1.136,74.1?F , 
DRTR 176.1. 202 ,74,176.1,232,74,142,16.183, 140 1 ~ 
9 RTR 106.141,13.183,86 


200.74 
183 
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SOFTWARE RF'F’1_I CRT I OM 

M O T EE: R- O o t 


lR'_•!-fcl—i r~--=: .s Joe HcEnerney and Eric Cotton 
Subject: s Clock Functions 

T 1 x s: ± S"t: oJ-=u~cJ s NTSC or PRL 


I <. Ft-fci -=^.*zc“F s This routine par-forms 
•functions, "the -foremost; being synchronizing "the 
program to the raster. In addition, it updates 
counters, a -frame clock, a seconds clock and a 
should be called once per -frame. 


various clock 
logic o-f the calling 
a set o-f eight -frame 
minutes clock. CLOCK 


I I - EKPOSITIOM = 
ft. Flow Chart: 
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B. Program listings: 
1. Source: 


100© .PAGE 'CLOCK' 


1010 ; 

1020 *=$0002 
1030 VARIABLES 
1040 CLKF *=*+1 

1050 CLKM *=*+1 

1060 CLKS *=*+•! 

1070 EFC *=*+8 

1080 FPS *=*+1 

1090 MOD *=*+1 

1100 RCOMP *=*+1 

1110 ,* 

1120 ;CONSTANT 
1130 RASTER =$0012 
1140 ; 

1150 *=$2000 


1160 

*• 

-r 



1170 

1180 

;CLOCK 

* 

SUBROUTINE 

1190 

CLOCK 

JSR 

NWAIT 

1200 


LDX 

#$07 

1210 

1220 

CLK0 

INC 

DEX 

EFC,X 

1230 


BPL 

CLK0 

1240 


LDA 

FPS 

1250 


STA 

MOD 

1260 


LDX 

CLKF 

1270 


JSR 

MODINC 

1280 


STX 

CLKF 

1290 


BNE 

CLK1 

1300 


LDA 

#60 

1310 


STA 

MOD 

1320 


LDX 

CLKS 

1330 


JSR 

MODINC 

1340 


STX 

CLKS 

1350 


BNE 

CLK1 

1360 


INC 

CLKM 

1370 

1380 

CLK1 

m 

r 

RTS 



)0R ELSEWHERE ON ZERO PAGE 

;FRAME CLOCK 
;MINUTES CLOCK 
;SECONDS CLOCK 
,*EVENT FRAME COUNTER 
;FRAMES-PER-SECQND <T.V. STANDARD) 
,• MODULUS 

;RASTER COMPARE VALUE 


jLSB'S OF RASTER VALUE 

;0R ELSEWHERE 

SUPPORT SUBROUTINES 

)WAIT UNTIL START OF NEXT FRAME 
INCREMENT THE 3 EVENT FRAME 
;COUNTERS MODULO 256 


;FRAMES PER SECOND VALUE 
;<50-PAL, 60—NTSC) 


;X = X+l MOD <FPS> 

,• UPDATE FRAME CLOCK 

;N0 MODULUS CROSSING THEPEFOPE F'-'tt 

)IF MODULUS CROSSING THEN... 

;SET 'MOD' TO 60 FOR 60 SEC/M IN 


;X = X+l MOD <60) 

;UPDATE SECONDS CLOCK 

;N0 MODULUS CROSSING THEREFORE 

;OTHERWISE UPDATE MINUTE CLOCK 


EXIT 


1390 ; 

1400 ;INC .X MODULO THE VALUE IN 'MOD'. 
1410 ; 


1420 MODINC INX 
1430 CF'X MOD 

1448 BCC MODIHI 

1450 LDX #$00 

1460 MODINI RTS 
1470 ; 


;CHECK FOR MODULUS CROSSING 
•IF X < MOO THEN EXIT 
;OTHERWISE X = 0 


1480 


1490 ;WAIT UNTIL THE RASTER VALUE MISMATCHES 
1500 ;THE CHOSEN COMPARE VALUE AND THEN WAIT 
1510 ;UNTIL THE RASTER VALUE MATCHES THE 


ra.cje 2 
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1520 ;COMPARE VALUE 
1530 


1540 NWAIT 

1550 

1560 

1570 WAIT 
1580 
1590 
1600 
1610 ,• 

1620 .END 


LDA RASTER 
CMP RCOMP 
BEQ NWAIT 
LDA RASTER 
CMP RCOMP 
BNE WAIT 
RTS 


;CHECK RASTER 
,*FOR MISMATCH 
;IF MATCH THEN 
CHECK RASTER AGAIN 
;FOR MATCH. 

}IF MISMATCH THEN CHECK AGAIN 


2. Hex dump (as assembled at $2000>: 

.t 2000 20 2F 20 A2 07 F6 05 CA 10 FB A5 06 85 07 A6 02 
. : 2010 20 27 20 86 02 D0 0F A9 3C 85 07 A6 04 20 27 20 
. : 2020 86 04 00 02 E6 03 60 E8 E4 07 90 02 A2 00 60 AD 
.: 2030 12 D0 C5 08 F0 F9 AD 12 D0 C5 08 D0 F9 60 


°■ Data statements (as assernb led at $2000>: 

1800 data 32,47,32,162,7,246,5,202,16,251,165,6,133,7,166,2 
1010 data 32,39,32,134,2,208,15,169,66,133,7,166,4,32,39,32 
1020 data 134,4,208,2,230,3,96,232,228,7,144,2,162,0,96,173 
1030 data 13,208,197,S,240,249,173,18,208,197,8,203,249,96 


C. Memory/Register requirements: The clock routine and 
auxi liary subroutines together occupy 62 ($3E> bytes of memory. The 
accumulator arid the x register are used as well as 14 bytes of zero 
page for variables. This allows for 8 event frame counters, but more 
may be added_if necessary (see section G be low). 


D. Worst case execution time is less than 16.91 milli-seconds 
on a NTSC system, 28.24 mi 11i-seconds on a PAL. 

r 


E. Limitations: Because the raster compare is made to the eight 
least significant bits only, the user is advised to limit 
raster-compare values to the range 57 through 255 ($39 through $ff) 
This limit assumes the controlling program is to run on both PAL? -n*i 
NTSC television systems. If on ly operation on NTSC systems is C 

intended, then the range 7 through 255 ($07 through $ff> 
applicable. 


F. Initialization: The clock routine requires th*t +i 
per second value of the television be stored in the utr-u ^ r3/ries 
This number should be either 58 (for PAL) or 60 for NT^r^ FPS * 
1390 to 1550 of the example for a technique to choose 1 H ries 

appropriate television system that the program is rum-.; 

."..triable RCOMP must be loaded with the raster compere on ” _ T ?f. 

PCOMP equal to $FA will provide the program with ther,^*! 0 ’ J** '^* n - 
KUl - greatest amounl 
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ot time to prepare tor the next frame. It the minutes/second clock 
is to be used then CLKF, CLKM, end CLKS should each be initialized 
with a zero. The event-frame-counters <EFC+0, EFC+1, EFC+2. . . > 
should be initialized in accordance with the requirements ot the 
program. These counters are provided so that the user can time 
events which require many trernes to display. 


G. CLOCKS 

1. Eight event-frame-counters are updated in this routine. 
CLOCK can be moditied to provide more (or fewer) counters bv 
changing the variable declaration in line 1070 ot the source listing 
and the index amount in line 1200. 

2. The 6526 Complex Intertace Adapter <CIA> -the MAX Machine 
has one, the Commodore 64 has two- has a Time ot Day clock <TOCO 
which may be used as an alternative to the seconds and minute-^ 

c locks provided by the CLOCK routine. See the chip spec i -fir at ion tor 
more intormation. 


H. Example: The to l lowing example demonstrates one us© ot the 
clock routine. When executed, this program will display aTsn lid * 
sprite on the screen as well as its x and y coordinate positions 
The user can then use a joystick <put in the port towardthe rear ot 
the C 64) to move the sprite to any posible x,y sprite Position The 
clock routine is used to update the sprite Position while"the r’=»st©r 
is ott screen and thus prevent the sprite trom flickering " 

Notes: a. To fully appreciate how synchronizing a program to 
the raster can improve appearance, try removing the clock r + • 

trom the example. The simplest way to do this is to remove iVn^Tosa 
-from xhe source listing. line l-- 1 J 

b. Sprite movement in this example is vcomniic^j ^ 

UNIMVX and MVSY. For an explanation ot these routing bX 

Replication Note 1001. w 

c. For an explanation ot the joystick routiVo 

Application Note 4003. routine reter to 


1000 
1010 
1020 
1030 
1040 
1050 
1 060 
1070 
1080 
1090 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 


.PAGE 'EXAMPLE' 

r 

o 

; **** EXAMPLE 

} Mm VICMON SHOULD 


•*=$0002 


,* VARIABLES 
OSH 
OSL 


MODH 

MOOL 

TX 

TA 

SMSB 

CLKF 


*=*+1 

*=*-i-l 


*=*+1 
*=*+1 
*=*+1 
*=*+1 
*=*+8 
*=*+1 


70 CLKM *=*+l 


OF CLOCK ROUTINE **** 

BE RESIDENT AT $S000 m# 


;OFFSET HIGH 
;OFFSET LOW 
;MODULUS HIGH 
,* MODULUS LOW 
;TEMP .X 
;TEMP .A 

;AUXILIARY SPRTtf 
;FRAME CLOCK E MSB BVTES 
;MINUTES CLOCK 
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1180 CLKS *•;=*+1 
1190 EFC #=*+8 
1200 FPS :+:=:+:+1 
1210 MOD *=#+1 
1220 RCOMP *=*+1 
1230 OX *=*+1 

1240 DV :•*=*+1 

1250 ; 

1260 ;CONSTANTS 
1270 SP0PTR =$07F8 
1280 SP0X =$0000 
1290 SP0V =$0001 
1380 MSIGX =$0010 
1310 RASHGH =$0011 
1320 RASTER =$0012 
1330 SPENA =$0015 
1340 XXPAND =$0010 


1350 ; 
1360 
1370 y 
1380 EXAM 
1390 
1400 
1410 
1428 

1430 EX0 
1440 

1450 EX1 

1460 

1470 

1480 

1490 

1500 

1510 

1520 

1530 

1540 EX2 
1550 
1560 ; 
1570 
1580 
1590 
1600 
1610 
1620 
1630 
1640 
1650 
1668 
1670 
1680 
1690 

1700 EX3 
1710 . 



*=$C000 

SEI 

LDA #50 
STA FPS 
LDX #$01 
LDY #$FS 
LDA RASHGH 
BPL EX0 
LDA #$08 
CMP RASTER 
BCC EX2 
LDA RASHGH 
BMI EX1 
LDX #$02 
LDY #$00 
LDA #60 
STA FPS 
STX MOOH 
STY MOOL 

f 

LDA #1 
STA SPENA 
STA XXPAND 
LDA #$7F 
STA SP0Y 
LDA #$S0 
STA SP0PTR 
LDA #$00 
STA SP0>< 

STA SMS3 
STA MSIGX 
LDX #62 
LDA #$FF 
STA $2000 y 
DEX 

BPL EX'3 


;SECONDS CLOCK 

;EVENT FRAME COUNTER ' 'V . ‘ 

; FRAMES-PER-SECOND CT.V. STANDARD > . **' 
MODULUS // . r 

;RASTER COMPARE VALUE ‘ ' 

;JOYSTICK X DIRECTION OFFSET " 

;JOYSTICK Y DIRECTION OFFSET 


,• SPRITE DATA POINTER 
; VIC REGISTER: SPRITE 
;VIC REGISTER: SPRITE 
;VIC REGISTER: SPRITE 
;VIC REGISTER: RASTER 
;VIC REGISTER: RASTER 
;VIC REGISTER: SPRITE 
;VIC REGISTER: SPRITE 


#0 X POSITION 

#0 Y POSITION 

MSB BITS 

MSB 

LSB'S 

ENABLE 

X-EXPANSION 


;DISABLE IRQS 

;ASSUME PAL UNLESS FOUND OTHERWISE 
; <PAL IS 50 FRAMES-PER-SEC> 

;SET UP PAL MODULUS MSB 
;SET UP PAL MODULUS LSB 
;LOOK AT RASTER MSB IS IT A 1 ? 

;IF 0 THEN RASTER < 256. SO LOOK AGAIN 
;RASTER > 255 ...BUT... 

;IS IT GREATER THAN 264 ? 
y IF YES THEN BRANCH. TV STD = PAL !! 

;IF NO THEN CHECK FOR MSB OF RASTER=1 
•IF YES THEN GOTO EX1 

;SET UP NTSC MODULUS MSB. TV STD = NTSC 
;SET UP NTSC MODULUS LSB 
; SET- UP NTSC FRAMES-PER-SECOND 
; <NTSC IS 60 FRAMES-PER-SECOND> 

;STORE IN MODULUS FOR FUTURE USE 


;ENABLE AND EXPAND SPRITE 8 

;SET SPRITE Y POSITION TO 127 
•SET SPRITE POINTER TO 128 
•CLEAR OUT SP0X, SMSB & MSIGX 


;SET SPRITE TO SOLID BLOCK 

,:NOTE:- IF SPRI TE F0INTER=i23 
• THEN SPRITE ADDRESS=$2000 
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1740 

JSR 

VTAMX 

1750 

LDA 

#$FA 

1760 

STA 

RCOMP 

1770 EX4 

JSR 

DJRR 

17S0 

BCC 

EXIT 

1790 

LDA 

#$00 

1800 

LDX 

DX 

1810 

JSR 

UNIMVX 

1820 

JSR 

ATVMX 

1830 

-LDA 

#$00 

1840 

LDY 

DY 

1850 

JSR 

MVSY 

I860 

LDA 

SMSB 

1870 

LDY 

#$00 

18S0 

JSR 

BTH 

1890 

LDA 

SP0X 

1900 

LDY 

#$02 

1910 

JSR 

BTH 

1920 

LDA 

SP0Y 

1930 

LDY 

#$06 

1940 

JSR 

BTH 

1950 

JSR 

CLOCK 

I960 

JMP 

EX4 

1978 



1980 EXIT 

CL I 


1990 

BRK 


2000 ; 



2010 ; 

CONVERT B' 

2020 ; 



2030 BTH 

PHA 


2040 

AND 

#$0F 

2850 

JSR 

CONV 

2060 

STA 

$0411,Y 

2070 

PLA 


2080 

LSR 

A 

2090 

LSR 

A 

2100 

LSR 

A 

2110 

LSR 

A 

2120 

JSR 

CONV 

2130 

STA 

$0410,Y 

2140 

RTS 


2150 ; 



2160 ; 

CONVERT H'i 

2170 ; 



21S0 CONV 

CMP 

#$0A 

2190 

BCC 

CONV 1 

2200 

SBC 

#$09 

2210 

RTS 


2220 CONV1 

ORA 

#$30 

2230 

RTS 



TRANSFER MSIGX BITS TO SMSB BVTES 
;SET RASTER COMPARE TO JUST OFF 
; BOTTOM OF ViSIBLE VIEWING AREA 
;READ THE JOYSTICK 

;IF C=0 THEN FIRE BUTTON PUSHED SO EXIT 
;LOAD .A WITH SPRITE NO. 

•LOAD .X WITH JOYSTICK X—DIRECTION OFFSET 
;MOVE SPRITE MODULO <504-PAL OR 512-NTSC) 
;TRANSFER SMSB BVTES TO MSIGX BITS 
;LOAD .A WITH SPRITE NO. 

;LOAD .Y WITH JOVSiICK Y—DIRECTION OFFSET 
;MOVE THE SPRITE IN V DIRECTION 
?CONVERT SPRITE X COORDINATE TO ASCII 
;HEX CHARACTERS FOR DISPLAY ON TV 
•BINARY TO HEX <SCREEN ASCII) CONVERTER 
;REPEAT FOR X LSB'S... 


;. . .AND Y 


;SYNCHRONIZE PROGRAM WITH RASTER 


;CLEAR INTERUPT DISABLE... 
,*...AND BREAK TO VICMON 


CONVERT BYTE TO TWO SCREEN HEX CHARACTERS 


CONVERT NYBBLE TO SCREEN CHARACTER HEX 


2240 ; 

2250 * 

2260 ; 

2270 f B 
2280 

2290 UNIMVX 
9/.1X82 


UNIVERSAL MOVE SPRITE IN X DIRECTIONS 
REG=SPRITE NO. X REG=OFFSET <2'S COMPLEMENT FORM'. 
STX TX ;PROTECT X 
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i 


2300 

STX 

OSL 

2310 

TAX 


2320 

ASL 

fl 

2330 

TfiY 


2340 

LDfl 

##00 

2350 

STfl 

OSH 

2360 

CLC 


2370 

LDfl 

OSL 

2330 

BPL 

UMX0 

2390 

EOR 

##FF 

2400 

ADC 

##01 

2410 

STfl 

OSL 

2420 

SEC 


2430 

LDfl 

MODL 

2440 

SBC 

OSL 

2450 

STfl 

OSL 

2460 

LDfl 

MODH 

2470 

SBC 

OSH 

2430 

STfl 

OSH 

2490 

CLC 



2506 

2510 

2520 

2530 

2540 

2550 

2560 

2570 

2530 

2590 

2600 

2610 

2620 

2630 

2640 

2650 

2660 

2670 

2630 

2630 

2700 

2710 

2720 

2730 

2740 

2750 

2760 

2770 

2780 

2780 

2300 

2810 

2820 

2830 

2840 

2850 


UMX0 


umxi 


VTflMX 

VTA0 


LDfl 

ADC 

STfl 

LDfl 

ADC 

STfl 

SEC 

LDfl 

SBC 

STfl 

LDfl 

SBC 

BCC 

STfl 

LDfl 

STfl 

TVfl 

LSR 

LDX 

RTS 


SP0X,Y 

OSL 

SP0X,Y 

SMSB,X 

OSH 

SMSB,X 

SP0X,V 

MODL 

Tfl 

SMSB,X 
MODH 
UMXI 
SMSB,X 
Tfl 

SP0X,Y 

fl 

TX 


SET UP OFFSET LOW. 
;. fl=X 
,*.fl=2$fl 
;. Y=fl 

,-CLEAR OFFSET HIGH 


i 

f 


'i ' ■ 


;CHECK FOR NEGATIVE OFFSET 
; IF POSITIVE THEN BRANCH ; 

;PERFORM 2'S COMPLEMENT OPERATION 

;PUT RESULTS IN OSL AND THEN 
,-FORM THE MODULAR COMPLEMENT OF 
;THE OFFSET BV SUBTRACTING IT 
;FROM THE MODULUS 

;PflL 504, NTSC 512 


.jflDD OFFSET TO SPRITE X 
;C SMSB+X,SP0X+Y 1 =.. . 

.CSMSB+X,SP0X+Y3+COSH,OSL3 


jIS THE SUM >= MODULUS 
;CHECK BY SUBTRACTING- 

;CATCH FOR LATER USE 


;IF SUM < MOD THEN EXIT 
jOTHERWISE CORRECT X.-COORO 


}RESTORE fl REG 
;RESTORE X REG 


ftTVMX 

ATV0 


TRANSFER SF-RITE MSB BYTES TO MSIGX BITS 

LDX #$07 
LDfl SMSB,X 
LSR fl 
ROL MSIGX 
DEX 

BPL ATV0 
RTS 

TRANSFER SPRITE MSIGX BITS TO MSB BYTES 

LDX ##07 
LDfl MSIGX 
LSR SMSB,X 
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2860 


ASL 

A . 

2876, 

•\2. 3 c .O- 

ZROL 

SMSB/X 

2880 

, » 

DEX: 

! z 

2390 

HIMVCi 

ZB PL" 

ZVTA0 ■ 

2900 


RTS 


2910 

• 


( 

2920 

r 

MOVE spr: 

2930 

'£ 590- 

;Z: T~ 

r f J * 

2940 

MVSV30. 

. ASL 

A • 5" 

2950 


TAX 


2960 


TYA 


2970 


ADC 

SP0Y,X 

2980 


STA 

SP0V,X 

2990 


CMP 

#$1D 

3000 


BCC 

MVSY0 

3010 


LDA 

#$F9 

3020 


CMP 

SP0Y,X 

3030 

MVSY0 

RTS 


3040 

• 



3050 

• 

JOYSTICK* 

3060 

• 



3070 

DJRR 

LDA 

$DC00 

3080 

DJRRB 

LDY 

#0 

3090 


LDX 

#0 

3100 


LSR 

A 

3110 


BCS 

DJR0 

3120 


DEY 


3130 

DJR0 

LSR 

A 

3140 


BCS 

DJR1 

3150 

i t '! • 

• I NY 

;\ w~ 

3160 

DJR1 

LSR 

A 

3170 


BCS 

DJR2 

3180 


DEX 


3190 

DJR2 

LSR 

A 

3200 


BCS 

DJR3 

3210 


I NX 


3220 

DJR3 

LSR 

A 

3230 


STX 

DX 

3240 


STY 

DV 

3250 


RTS 


3260 

m 

r 






'?-'L' ;AT STRRT .A SHOULD BE LORDED WITH SPR# 
,•.X=2*SPR# 

;OFFSET MOVED INTO .R 
% OFFSET IS RDGED TO SPR V POSITION 
;SUM IS NEW V POSITION 
,*IF Y<$1D THEN C=0 
; <RND BRRNCH TO EXIT} 

,“ ELSE IS Y>$F9? CLAST V ON SCREENS 
;CRRRV IS UPDATED ACCORDINGLV 
;EXIT 


; <GET INPUT FROM PORT R ONLY) 

;READ AND DECODE THE JOVSTICK/FIRE- 
BUTTON INPUT DATA IN .A; THE 5 LSB'S 
;CONTAIN THE SWITCH CLOSURE INFORMATION. 

;IF A SWITCH IS CLOSED THEN IT PRO¬ 
DUCES A D BIT. IF A SWITCH IS OPEN 
;THEN IT PRODUCES A 1 BIT. THE JOY¬ 
STICK DIRECTIONS ARE RIGHT, LEFT, 

?FORWARD, BACKWARD. B3=RIGHT, B2=LEFT 
;B1=BACKWARD, B0=FORWARD AND B4=FIRE # 
SUTTON* AT RTS TIME DX AND DY CONTAIN 
;2'S COMPLEMENT DIRECTION #'S, I £ 

.^FF=-1, $00=0, $01=1. DX=-1 <MOVe" 

;LEFT>, DX=1 <MOVE RIGHTS, DX=0 CNO * 

;CHANGE}. DY=-1 (MOVE UP SCREEN' 1 nv-i 
; <MOVE DOWN SCREEN}, DY=0 <NO v'cHflkirp'. 
j THE FORWARD JOYSTICK POSITION CORRESPOND* 
■.TO HOVE UP THE SCREEN fiND THE ERCHUfiRn 
BOSITION TO MOVE DOWN SCREEN? - KWHRD 


3270 
3230 
3290 
3300 
3310 
3320 ; 

3330 CLOCK 

OC ^ C * 

3350 CLK0 

3360 

3370 

3380 

3390 

3400 

3410 


;AT RTS TIME THE CARRY FLAG CONTAINS THE FIRE BUTTON croTr 
;IF C=1 THEN BUTTON NOT PRESSED. IF C=0 THEN PRESSED E ‘ 


•CLOCK SUBROUTINE AND SUPPORT SUBROUTINES 

;WAIT UNTIL START OF NEXT rr 'CMr 
; INCREMENT Tr£ 8 
; COUNTERS MODULO --- rr HriE 


JSR NWAIT 
LDX #$07 
INC EFC,X 
DEX 

BPL CLK0 
LDA FPS 
STA MOD 
LDX CLKF 
JSR MODINC 


• v =.NT 
256 


’ FRAMES PER SECOND VflLI IF 
;<o0-PAL, 60-NTSC} 

■X = X+l MOD <FPS> 
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3420 

STX 

CLKF 

; UPDATE FRAME CLOCK f, SIP 

QSSS 

3430 

BNE 

CLK1 

;NO MODULUS CROSSING^THEREFORE 

.EXETT 8 S 

3440 

LDA 

#60 

;IF MODULUS CROSSING THEN... 


3450 

STA 

MOD 

;SET 'MOD-' TO 60 FOR SGJ^C/MIN VP?! 

3460 

LDX 

CLKS 

STS 


3470 

•JSR 

MODINC 

;X = X+l MOD <60) 

; ' 2 

3430 

STX 

CLKS 

y UPDATE SECONDS CLOCK -T 

• y s. Zt 

3490 

BNE 

CLK 1 

;NO MOOULUS CROSSING THEREFORE 

Exrtz~ 

3500 

3510 

INC 

CLK1 RTS 

CLKM 

;OTHERWISE UPDATE MINUTE CLOCK? 

V : . 

vf, 

esic 

3520 

r 


• •• 


3530 

3540 

3550 

y INC . X MODULO THE 

MODINC INX 

VALUE IN 'MOD'. V • DC- 

’ ‘v **‘ r - ■’c- nTc 

£~rc* 

C-CiO .7 

3560 

CPX 

MOD 

;CHECK FOR MODULUS CROSSING 


3570 

BCC 

MOOINI 

;IF X < MOD THEN EXIT ALJ 

6 f: ' 

3580 

3590 

LDX 

MODINI RTS 

#$00 

;OTHERWISE X = 8 -T - 



3600 
3610 
3620 
3630 
3640 
3650 ; 

3660 NWAIT 

3670 

36S0 

3630 WAIT 
3700 
3710 
3720 
3730 ; 

3740 .END 
READY. 


;WflIT UNTIL THE RASTER VALUE MISMATCHES 
;THE CHOSEN COMPARE VALUE AND THEN WAITS 
;UNTIL THE RASTER VALUE MATCHES THE 
;COMPARE VALUE. 


LDA RASTER 
CMP RCOMP 
BEQ NWAIT 
LDA RASTER 
CMP RCOMP 
BNE WAIT 
RTS 


■ -9 1 > v c 

; S J 
- 0 

•"i n 0 6;; 

P c, r 


y CHECK RASTER 
;FOR MISMATCH 

;IF MATCH THEN CHECK AGAIN 
> CHECK RASTER 6 T- .■ 

;FOR MATCH c«.C £33 

,• IF. MISMATCH THEN CHECK AGAIN 


S^‘.r 


@2 

SC i £ 


S*: 
Sc: 




c:T.q T^x 

H 2 ^ - 1 : 


i • /oaau? y. 


-* « rt r 

~ ** • 


1 - 
r.- 


*.>u; 
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J Andy Finkel 


LJ L- -J L_ CJ I • Us i r.S the Coft««iodore 64 3 s 3 R 3 ;< Lwu 1 3 t 0 r 

TV STANDARD s NTSC or PAL 


ABSTRACT 


The CoAiiiiodorc 64 can be used to emu 1 3 1e 3 Co aia; od 0 r e R 3 j< ciur i n 3 
software development fo : " the latter machine. This dives several 
advantages including the use of development tools on the 64 , the 
ability to test the program in RAM (which ends the need to 
constantly write LPRORs in order to test the program >r and the use 
of the 64 peripherals. 

IMPOSITION 

A brief review of the wsy in which RAX programs should be 
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3 A P P N 0 T £ : • 400$ v -• - '• " ’ 


;1AX OsiVliLOP.YcN f SYSFCh 


either in the 4I( block beginning at J-TCiCjO or the RAfi from t0002 to 
$Oi-TF. r ' : ‘ ,r C C--A 

NO! Li Re as eater that the kOtt graphics block at tF 000 waps down to 
$ 3 do0 * from-the 1 p'q int of view of- ,: the' VIC -T-I chip. v 


* c r 


' v. c• r_* "» o »- r* i»' 


ic n »i . . 


ti •:* :* * • 


The object then* is to configure the Commodore 64 to match 
this specification. The memory confiduration of the 64 is 
controlled by location 1. u Hacir.S a $C5 into location 1 will switch 
out both SASIC 3nd the K£RNAu. The MAX program must replace the 
KERNAL. ' 

The other problem is to simulate the graphics-mapping effect 
for the VIC-II chip. This is accomplished by having the program 
section that goes from tfOOO-trffF also loaded at £3000- t3FTT 

’Jut •' 

There is no problem if your program requires the e:<tra 2K of 

* ‘ .» t~ **] 

FcAttr since the Commodore 6^-always has kAfl there. 


. / > ! 
i a ■; 


XT/ Th*. jLGIv • 
U/U « j i i A 1 J- £ : 

ft A >• : 


DUG; 


0 s. G u 


-> u. 

2 p .’t 
•*; i 


H3ATE 


J G A 4 < 0 > i J.. 


j ; 


: -jjU l * 
*00 0 ‘ 


* j“; f* 

-i u 0 C 
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Apr NOIL 40.G.0 


MAX 0 L V LLOifM L.N S Y 0 }, LM 


-'to OOC'ii i s ;.n , •• n i 5 f* d '; n» o J - ;j >!> ,<» -ss-fO 

COMPARISON OF nisi MAX AND COMMODORE 64 MEMORY MAPS 


: • ; 


.'•''-v-m 

1> i ^ 6> ‘?5r t* 0 /I LOtv" rift * '! Cs «: *> »l; /! * J ! 0 V, 

1 h* ftiimora map of the-i Co<«n.Ouor§ (,& , aftgr - fjs 4.15 s ^thi {|1 $AX. LMU-• r 
pro3ram is shown compared with the memory msp of the Max. 


FFFF 
FOOD 

FOOD 

E000 

D 000 

A000 

0000 

4000 

3000 

1000 

0000 

0400 

0200 

0100 

0002 
0001 

0000 

9 / 15/02 


MAX ’°"'“ 

f *Y» C J 

* 6 •; 

0 - i C 

: -ROR ,.., c 


5 SPACE 

9 

9 

*• * l * ~ - '• h) 1» 

luT ’IT 

POM 

9 

r 

5 CF’ACE 

r 

; VIC CHIP- 

j 

5 (I/O) 

C i, 

9 

•'*:" , J~ T* < ‘ v 


5 UNUSED 

• 

T 

.- J : ■'' : 

9 

5 . POM 

Z 

5 SPACE 

9 

9 

-- 

.. - 

UNUSED 

9 

9 

9 

• — ... 

9 

5 VIC SHADOW 

or 5 

5 $FOOO-$FFF 

f 9 

5 UNUSED 

9 

9 

5 2K PAM 

9 

9 

5 expansion apea 5 

5 VIOEO MATRIX 5 

54 SPRITE PNTRCs 

5 PAM 

9 

9 

9 

9 




r»: j w 

a ; t "• j d.-:- » ;jo n * 

•- 1? r' r * C - •*' -M ' 

FFFF 

-je 00 

** % .. r-c i ,7 e o i i c i j 

5 , PAM•- - 0 j • r ^ I bs/.i o'ii. 10 ; 

» * 

r!’i rClOO 

»r> •“ r 'is Dir AS n^oc‘ 

5 RAM 5 

EOOO 

: ; . jb.y.x ! )( 

'.u .**' c *• * 

5 VIC CHIP ... 5 i 

5 (I/O) 5 

DOOO 

< «: . 1 • -.-Hi \c ** 

1 RAM 

i ; 

: n .. 

AOOO 

. 

'\ l.t 0 ‘z 

(?:\ i Sr'f.'Aft Oit a 1 ?• »*? 

; * 

?k6 ,..eooo 0 , 

0 5;» 0«... 0 S T? • : •- ^ ^ 


X 

y 

m\ 

x 


xxx 4000 

y t 

•s 9 

v v 

•% t 

3000 • 


FvAM 


y 


STACK 

2 LFv 0 PAGE 


-:c VIC ic 
x CHIPS 
•x MCM x 
x MAP x 
x AFcEA-x 


-s 


1000 

ocoo 

0400 

z 

9 

9 

0200 - - 

* 

9 

9 

T 

0100 . 


PAM 

(MAX.EMU pr-s ) : 


PAM 


5 VIDEO MATRIX 
*•8 SPRITE F'TFvC 

J F\’AM 


STACK 
ZCRO F‘AGL 


; 6 t /10 PEG I STEP : 
: 6510 DDK 


0002 '-- - - 

0001 :6510 PEG 13 FEP; 
5 6510 OOP 

0000 
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A'i'V NO r£ 411013 


hax oevltopfiln r system 


sufcM'AfrY. 


r-\ - e~ 


fc » ;:• :?z •• 


• r • S • ' •* : i ^ ft C, iV* 

, j q; j * ■ o ^ ' ♦. # 


1) Assemble the Pi AX proSr 3M'"at $EDTJTJfor an OK cartr i else program 

3t $F000 for a 4K cartridge program 
at tFOOO for a 2K cartridge program 

fteaember to include the interrupt and reset vectors for the 6510 
chip at $FTrA. 

2) Do ar, OfTCLT load using the IIILOADLR. C4 program included with 
the Commodore 64 Assembler Development System- use an offset of 
4000. This will offset your program as -follows? 

PftOGfiArt WILL 3l£ LOADED AT 


$EOOO- $LFTF 
$FG00-$FFFF 


$2GO0-$2F f F 
$3000 -$3FFF 


3) Now LOAD the ttAX. LF;U program as execute it as -follows 

LOAD "MAX.EMU" r'3r 1 
3Y0 9*256 


Your program will be transfer-ed from $2000-$3FrF to 
$£000-$f FFF r the memory will oe t ecGhriguredr and execution will 
begin at the address specified by the- FvLO vector in your MAX 
p r o d r 3 fn • 

please note that the max emulator program is completely 
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Apr N'Ol L <000 . 


MAX DC. ML LOP ML. N'T 0YD1Ltt 

vU'Ji' J • U>i !'iA 


relocatable. It can be Moved any where r i? the location occupies 

y / , tr 1 
.•tr.ff »t ! w 

conflicts with another develop went tool. The zero pasJe location: 
can be can .be charged by ..reassembly. 

- * J 1 ^ -• w- <'ifc * 1 C ' \.}'j L~:-* v e i.*t 6 "*■ H 0 "l c , -. r •. 

‘ ’* »• c- "* '* c *iO ** Ot’U .’ f- 


• ,1 


•. J 


'■<0 


r 1 Z> ■ U v ' ■* 


* '»c\ c-'iojos-v v +csf.'- t.;-s i s :r»d stuiam cc 

, H ’ 1 < •? j £ <1 | , 


• h - • «Vr z> *"* ^ C * 1 ~ . 


<- ! >.-? f c L * }i- 


>0- - J':I t •• • 

* * • v «e : v ' •- 

, i|i ~ V ? C. * J *> W f • c 


rSC ‘ 'j* SK (£ 

>* : -■* * vl • N C L* OiM», :•£ *rf\f 

'. ; • > c ’• *'• ** . 0 lj » v< * r 


; -: 5 r 0 ^ j r j j 1 u. n A :• t i> 0 




• i?u ;v;> 

: r j- fr /» r . * -s 
- * ’Jvbw* 


v-k • j j *:• c 


»P V. ^ C C ! '•* L‘ J . A /- S . • * 0 A .J 


s,> O f 


l *0 - "UKB.XAf: 


6v His; 

" • ^ k,' T» t« >* £< 

**■ n 


"•3 ii iw ms < 

y; ir ♦•»£»».» 

V - c-c.r *llr<tv 
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APR NO TE 4GOU 


•W DE.V£LOPrtEN f SYS FEtt 


SOUFx'CL LISTING 


1000 

. F’AG 'EflU.S' 

1010 

1020 

1030 

* 

r 


?x- COililODORE 64 MAX E." 

1040 

» y ■/ •/ y •/ •* y 

f A A A A A A A .V A 

■/ •/ v •/ y y y y y •/ v 

1050 

r 


1060 

JOAF^IADLLO 


1070 

r J ~' ■ 

.1 

1000 

•:c-$0002- : 

• . . . *■ 

1090 

SOURCE x=5 

+2 c ;; r 

1100 

TAFv’GLT «*»« 

i 2 • 

1110 

r 

V. .. ' •• •. 

1120 

•5 = $0900 


1130 

r 


1140 

LKU CLI 


1150 

• "LDA 

ftOO" : i: • - 

1160 

STA 

SOUFx’CL 

1170 

STA 

TARGET 

1175 

STA 

$DCOL 

1100 

* 

r 


1190 

LDA 

ft $20 

1200 

STA 

SOURCE !-l 

1210 

* 

r 


1220 

LDA 

ft$LO 

1230 

STA 

TARGETM 

1240 

7 


1250 

LDA 

ft$E5 

1260 

STA 

$01 

1270 

7 


1200 

LDY 

ft$00 

1290 

AGAIN LDA 

(SOURCE),Y 

1300 

STA 

(T Afv’GCT ) r Y 

1310 

INC 

TARGET 

1320 

INC 

SOURCE 

1330 

3NE 

AGAIN 

1340 

* 

r 


1350 

INC 

TAFCGET-: 1 

1360 

INC 

SOURCEH 

1370 

7 


1300 

LDA 

SOURCE-: 1 

1390 

CilP 

ft$40 

1400 

L’NL 

AGAIN 

1410 

7 


1420 

JNP 

($r FFC) 

1430 

7 


1440 

.END 



• V c. 


% 1 
L ' 


i U 

- v-‘ 

*.f» ? 


.r r 


FDISADLL INTLRRUF’Tp.,. 


?TURN Off 1 IfiCFx ON CIA ftl 


rTUFvN OFF KLF-lNAL AND DACIC 
;NOW DO 1 ML 1 FxANSF ER 


r D0Ni£ YET ? 

;NO 

; ST AfxT C'rAX PROSCAN 
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FaS* C 




V... .«• ■&*».+*.***&*• - f ' *-<"£*•* - ... 


-i?- 








A!**P Nofi£ ;: fa'OU 


MAX DEVELOPMENT SYS TEA 


HEX DUMP 


.: 0900 70 

A 9 

00 

05 

02 05 

04 

OD 

, : 0900 0E 

DC 

A 9 

20 

05 03 

A 9 

EO 

0910 05 

05 

A 9 

E5 

05 01 

AO 

00 

0910 81 

02 

91 

04 

E6 04 

E6 

02 

.: 0920 DO 

r 6 

E6 

05 

E6 03 

AS 

03 

.: 0920 C9 

40 

00 

EC 

6C PC 

cc 

1 1 

•»• *• • 

DATA STATEMENTS 



• s 

> .«• . 

• - 

DATA 120, 

169 

t 

0, 

13 3 , 

2, 

133, 

DATA 169, 

32, 

13 3, 

3, 

169 

, 224, 

DATA 229, 

133 

r 

1, 

160, 

0, 

177, 




4, 


v-.aJSA WfiVT viC 

HI, IX r 220 


SI.; i.: 

*i/.‘ I» i ’ — 

V, 

i » 


DAI A 
DATA 


4, 230 , 4, 230, 2, 203, 

b, 230, 3, 165, 3, 201, 

236, 100, 252, 255 


\J V * 

• • •• >. 


246, 230 

64, 200 


NOTL: K&ttetiber that th-a" emulator’ program is ralocatabl* 


0> 11 
„ . *■ i 


'*c vi;u T 


Jwi ' 

iCJ 




: -r r > 

: ' 

C-cic i 
r-/ f ‘ 


.J** 
„ • u ' * *■ 


/: ’’ ; 
AC... 


^ h , 


y* *• 


A J 


. 

^ i/4, 
* * 


V; J. H £'• H ;A‘ 


U: 2 


T2-5/;A r 3-'J 
,CC jv.. 


. 23^U*r:- 2 

: ?v.2 

v.]A-|,r J 

'* t • \ 
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Ff«-4“feh”i•“«r~-s Joe McEnerhey 'arid Eric Cotton 
Sufc:* j »=-azi s Power* On Clear-* 

"T *=- 1 •=•■-* ± :=: ± .n. r~i S-fesJ’id.ar' ci s NTSC or PPL 


I - Hbs^ract s The Power On Clean <POQ> routine performs 
many of the setup duties necessary in most programs. Among otho*-- 
functions it will: 

1. initialize the microprocessor stack pointer 

2. initialize the 6366/67 VIC registers 

3. clear the 6581 SID registers 

4. determine the television standard 

5. set up the I/O ports 

6. set up the video and color matrices 

7. stop all interrupts from the 6326 CIA 

3. set up the sprite pointers 

9. set up interrupt structure 

All or part of this routine may be used in accordance with the 
requirements of the user's program. Also, the user may wish to 
change some of the constants to meet his particular needs. 


1 I r EXPOS ITI 01-4 = 


A. Flow Chart: The following chart summarizes the functions of 
Pul and i l lustrates.the order in which they are executed. 


d i s ei:« 1 »=• IR Q S 

>■ lean decimal mode 

*=:i=»t UP I/O ports 

set stack pointer 

c 1 ear zero pesje- - 

clear VIC registers 

c lear- SID registers- 

set up 6510 DDK 

- lnitiAii-rc ir: redisters 

determine T.V- standard 

c lear and co lor screen- • - 

o l*5r timer .=• control re*u 

set up sprite pointers • •• 

prepare IRQ's 

enab le IRQ'S ■ -* 
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C O Hi mod OP *=* 


page 1 

























100Q . page -'power Wi> $$££&• 

101 0 .: 

1020 yip*m POWER. ON CLEAR ROUTINE mw 
1030 




Wxf"; >i:'- 



■ — . , . — . — - - - — mi>. i f i_i r i_i r j ,c. 

1070 ;SETS UP THE VIDEO/COLOR MATRICES, STOPS ALL INTERRUPT 0 FROM 
1080 ;TH.E PlNp §ETS UR .THE-- -DPRI^E-;;PQENTERS ; : AS THE-USER^SPeV iftf^ 

1090 ,* ' :VJ V -«U ICS*:. ' "'A***- ; ES 

1100 *=$0002 '• "" ^ t %0 ffSf- ^'SB^tERE ON PAGE -'SERp . .. - T- 


;FRAMES-PER-SECONO DEPENDS, ON TV STD 
;X START POSITION FOR'STV ^STANDARD / 
;TV STD MODULUS HIGH ' . 

.*TV STQ MQjQUJjyS LOW £• 5 riKyr- , 

■A JMV > ?*••• Sii>li~f ZL? ~ * - I C!“ Z t Z 


'l 


V- ' *.V 
ii f 


1110 ,• VAR IABLES -****•- 
1120 FPS *=*+1 

1130 XSTRf *=*+1 

1140 MODH *=*+1 

1130 MQDL *=*+1 

1180 %. <£**• C; f„s<. 

1170 /CONSTANTS £$*>,•.-. • 

1180 CIAIEM =$7F i-F >. J 
1190 CNO *S00- }■ j 
1.200 COLOR £=$05. *>*• 

121p;..SRS^ =$08,5,*-.. > ? 3T /START I NO PSM: SPRITE: NUMBER 

1220 VIC I EM =$00 ,,1^;,. ^V:I;C -iF^.-ENABLE MASK,/NOTHING ENABLED 5 * 

1.230 VRTL =$07<*,©j y&jn <£0®; REGISTER TABLE. LENGTH-1 

1240 VRGM, * =$11 V* . h/.iv:AV.M V.B©«-REG:I ATTR OFFSET.. V •• 


L 


./CIA- IRQ ENABLE MASK* /NOTHING ENABLED-} 
.vv ^CHARACTER^NUMBER FOR-CLEAR SCREEN - 
, P'i/COLpR; FOR'^FOREGROUND-. NYBBLE <GREEN} : ' 

•i- » nOT T-i i rs. r-~,T>+v4 , ^nnrrr-- l.i« 



& r. 


... 


as-r^t 


cl 

1330 

1.340 *=$3000 
1358 ; v j?-: - • < 

1380 ;* DISABLE IRONS’^ 

1370 POC SEI 

1380 } 

1390 .•* CLEAR DECIMAL MODE * 
1400 CLD 

1410 ; / 

1420 ,* sej UP J£0/;RQRTS 

LDX #$00 
STX CIA+3 
TXR 
DEX 

STX CIA+2 


;DUMMY ASSEMBLE POINT;. Q 

s * ,*V 


• - 


. 2 t 




.. V 




a.*\ • 

V' — 




1430 
1440 
1430 
1460 
1470 
1480 ; 

1490 SET 

1 500 

1510 


;SET PORT B TO INPUTS• C&Xgzi 
,;.A=X SV^.,.ri; 

) . X=$FF . 7 

.•SET PORT A. TO OUTPUTS '^6^28} 


STACK POINTER 
TXS 


*•?'• v- s 

; r .X=$FF 


y ~T. IT- 


•!•*»*■ -, . 7 . 


%«v« 




pacie 




1520 s* 'CLEAR PG 0 < EXCEPT 0, 1>, flNO VIC ; FfND-SlD ' REGISTER'S V 
1530 ‘ DEX >.X=$FE 

1540 POC0 STR $01,X ;<.R=$00> CLEAR PG 0 EN£EPT : ?0 > $ 

1550 StA VIC,X ;CLEAR VIC REGISTERS 

1560 STR SID,X ;CLEAR STD REGISTERS!,'.' 

1570 DEX . . •; W&i 

1580 BNE POC0 2ViTT)ii*^ M-fed? :*(C £aW3$ 7 |$£G'*, 

1590 ; 



1650 LDX #VRTL ,:SET UP VIC ,REG TABLE LENGTH 

1660 PQCi LDW-VTffli^ vV: REG TABLE W*i&M %£A-l 

■SET^i^v:-^ .•« ^4.j 


1710 ?W. DETERMINE T. V. -STANDARD' i iT ? "' r ! 

1720 LDA #50 ;ASSUME PAL UNLESS.FOUND OTHERWISE 

1730 STA FPS i (!PAL IS 50 FRAMES-PFRL'feirr V • 'a &*'• ’ • 



1790 
1800 

1810 SWAfc 

1320 BMI ROCS'”' ;'iF i '"VES fHEN\ CHECK - w , 

1830 I NX -7V- SSTr SET-UP NTSC MOGBtiOfe 4 - MSB. TV STD^NTsr 

1840 LDV :#$00 “ £.p* /SET” UPiNTSC MODULUS L$B ?CV* ► : £ ' 

1850- LDA’:#60^ v : " SET UP? NTSC FRAMES-PER-SEC* A! 4 > •« . 

I860* stA FPS i; <NTSC IS 60 FRAMES-'PERrSEC> 7 ; - .>V?> 

1870 P0C4 STX MOON: .Vr' ;STORE iN-MODULUS FOR FUttlRE USE > ... •; ■% ' 

1880 STV MODL r -; -4 '; G X'#*« A ’i.' /‘j /> • 

. ... t >i. -\, 

1900 ;H? CLEAR AND COLOR- THE ^SCREEN’ # • it . 

LDX #0 
LDA #CNO 
STA VM,X 
STA VM+256,X 

STR VM+512,X v 

STA VM+763,X 

LDA #COLOR ;COLOR FOR NVB 

STR CM,X ;CM=COLOR MATR 

STA CM+256,X 

SWtCM+STS^;: if :. i ?•;<- 
STA CM+763 ,X •'*'*' < 

D EX i’lV*-. i V 

BNEiiPOiSS ..SfX ’••'STs i 


1880 
1390 
19G0 
1910 
1920 P0C5 
1930 
1940 
1950 
I960 
1970 
1980 

1990 
2000 
2010 
2020 
2030 
2040 * 
2050 
2060 
2070 



•J. *■>”< 0 


A 




'-LEAR OUT THE TIMER A CONTROL . - 

; , < opt IONAL FOR MAXFTVt.'-, r 

LDA #$130 


>«> 


g> ; '* 





i 


’■ ■ ; 

it 

» f ' r 

V* 

tiW? 
s 1 v. 


0 > 3 -i. f 


if if 

*« 



’■ ■ l 

Y,) 4 ,* j 


: 


> 1 *. '• , 



s 

> } ••«.; 

i v 

; 



> 

# ^; 
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2080 STfl C.ia+$E 

2090 ; : T&*-' ; 

2100 ' ?* SET UP SPRITE. POINTERS * 

■_2'.l 10/. • “ I i ■ -LDtCMT,-' t; /I r ’- .a-tX^J'22: "-ivi-- • ; Ct 

. ;.21.2>3.1 r I v 0 - Silj.Dfr'-'ttSR'SN T--.- -S^SGT,: •. 7 
•;2K30 .P0CS3 • o?: o£ s . sSS . ' . . r -;-... ss- ^mbsst. M 

2140 "': -STft^VM+ 10 iS>x i :-2 ?• e&i • .. 3 .- 2 . •. : . .r*v , . 

2i50 ; -• ■. i3|N?-; 25' :._••-••• -*€: .• c./ss: ,■•:.•? . s&u;? >?•.. so. 

2lS® ■ - "DBX'S--vr 1 .•* • . ’ ■■' SI v? 1 ■> »••> •-••' v.’. .«&?*; '. 0 - 


t -V-. 



2210 

22201 

2230 

2240 


STfl VI C+$ 1 fl :C/VIC ?IRQ ‘"ENABLE >REG ; O'J. nanfe* 
LDfl'#CIfllEM ;LOAD CI fl IRQ MASK ENABLES 

STfl CIfl+$D‘ ;CIfl IRQ CONTROL REGISTER 
LDfl Clfl+tD 


2S&&W .*".' *■> -110A 



STfl 


.IRQ VECTOR' • .•***= * 

i>•STfl-.-rlRQVEC -iOv-;--IRQ:VEC=« 0314 FOR ; G-S4' ?f‘:«$?• 

STfl IRQVEC+1 


-i Cr - 


V-. ft*\£ 
... •..>« /.* 


•2-260 rO 
. 22702- -.: 

: v2280;i*T 
2290 
230€i 
2310; 

-2320 i.;*. aS-EhtflE:LE vlfRQ'-S-^ *i% - ;,v 
2330 CLI .J*S rv.::. 

2340 ; 

2350 MflINX JMP MflINX ;FIX TO JUMP OVER VTBL. ET RETERfl 

2360 IRQ JMP <IRQVEO ;GAME IRQ VECTORS :HBF^^FROH<-TC)pitJF mpmiww 

: 2S70;-IRQDSTf: ,RT'I?' ■ «?//.:«*> , ^ E>fclMMV : ROUTINE;! ^ #• ' ntnuKV 

••- 2 S. 80 r Z? • &?/y! *^> v - 




»rvo 







2450‘f:.;l : 


•v .«/' V’fe*?' 


r 

‘,{J : .. 

' - •■■' 


rr/-*r 

24S0-V. EN0'-r 

Vjw.'— 

,>r. 

*•* *V 1 

tj.: tj. 




: - 



«’ L«r 

. 1 > **• :: 7 

:y. . .' 

f-v- 


■' 







•c ; r ! ' 

-v .vi . ;- “ 

p jMt? 

J . =f f.i 

V. . 



its 



i 

r« • ( '' 

1 ; 4- ' 

./ ». • 

•1 *.«*:.• 

2sf 

Hex3duiftif>- 

C-se: l^dV'. 


■/S'..' 3SOtO> 

:78 

08. 

• - - t . 

A2 - 06 -SE 

63 

'.DC • 8fl 

Cfl 

8E 

. : 3010 

90 

00 

00 90 

00 

04 

•Cfl 

00 

F5 

A9 

. : 3020 

A3 

30 ‘ 

90 11 

00 

Cfl 

10 

F7 

A9 

32 

.: 3038 

ftO 

11 

06 10 

FB 

A9 

08 

CD 

12 

00 

.: 3040 

F4 

E8 : 

fl0 00 

fl9 

3C 

S5 

02 

86 

04 

. : 3850 

90 

00 

04' 90 ‘ 

00 

05 

90 

00 

06 

90 

. : 3860 

08 

90 

00 09 

90 

00 

Ofl 

90 

00 

oe 

. : 3070 

0E 

DC 

A2 07 

A0 

08 

98 

90 

F8 

07 

. : SOSO 

80 

lfl 

00 A9 

7F 

80 

00 

DC 

AO 

00 

. ; 3090 

00 

A9 

A2 SO 

14 

03 

A9 

36 

80 

15 

. : 30fl0 

14 

03 

40 5B 

F9 

00 

00 

FF 

08 

00 


•V^frgv- 


-f. ~iV 


|V>.. 


?•» 7 ly 1.. 


‘ ■; vi »i--^ . yWl- 


■ * •'/• vJV 


9/13/02 


Comn'iodcr 


4 


... » ,v.v •• • «^»* < • • ■ . — . ... : .Cl- • 1 • *• ■». -■ >.'*< 1 ^. ^ 












3 / . D^.ta.. / si?.atem^'t:s . <as. : '.rassejnb led; .x“fc ^3000-5.:‘, * »&>§©.'£•' 

V-v ’=FH^ 73S. ^ * S’§. i£; 


S£t£* 


20 O0 data .20/2,64 

j.q'^»q££ *m[ .. . %%*&&& &$£% 



X w « r — V*^ c.‘tn , £.Otf.. / x e'v * x , pw , i oo> c: , I Orf’.* ** >. 1 -I*cl , ^>*40 4 . 

1050 data 157,0,4,157,0;5/157;0,6, 157/0,7,163, 5>:tS7,0 
1060. data 216,157,0,217>'157,0,218, 157,0,21 SK/20@/^0,225/ 169i?®SLl41 
1070 data; 14,220; 162,7, 160,3, 152; 157>24.3,7:;200^202V;16,24S, L$?.££i 
1030 data. 141,26>208:, 163;127, 141 ,25 

i o-=ii-i d*+* ! ^g^^^^l4^^.i^g.l:j^48',i ^$^il£^, r 8Qi£.76 , 156^48^t03 

QvtS&r 

*si|7. 

. &#s&i 

4tii5«j3fci na;, regu iSSaS?. 171 

_ - • •.w'.iks, 4(5^3/11; recji'Sifep. 

t-si:. la .as we 11 as bytes/-tar*. In addition, 

4 bytes are ,on • zer^frage. 

The accumulator and the. x and y. registenpn.arjfr W y.? -’ 

■ ’ ; . £2j\ 

D. Worst case execution time^. is . less - th&riidLjf^^i^siefeond fiaKr'a,• PflL 
television system, 1/25 second, on a PflL. ' ■ ■ C/# - ; • ~ 

• \ • r V4* C c.-" 

: 77 : V JcfT ■» Of* '■■ '’ ; v -••,» : . §tf: N4-11RM &gB$3 

,, E; •;; User _ Wot^ r :^: ;.;->• ggg <. -..■ *W ; V qc , cafofr S 

1. Lines 20|70^and»20S0: ot^tfre.- source. IisMftgT.l&^-bptidfta 1 
tor programs made to run on the MFiX Machine;.alone. Clfl+SE; is^icpaeared 
on power-up*., SucItt. is ; ; hPt v the^^.eTon> thev Comirtodohe: ®4^*bV i t- Clfl ' 

i nterrupts are to: be disab.led > this,' reg i sten.- Sw-Tsit - ben sit tnv©.< by the 

program/: {iw p& ... ; -,. / ■/■=-:/ . -: 9 i * ' : gif •' ;-.r-gp- '• ftifm ' 

2. ■«$*& PQ&,bdutioeVhas^heeh- i^dr/iiJ^^ctSons&sOJ. that 

the user can easi ly modity the routine.to meet-the. needs of his' 
particu lan program** I.n the source,; listing - ;, each; sect ion isfo headed by 
a comment (.describing the tunction> surrounded by asterisks^ It" a 
section is not needed it can be deleted without-a-f-fecting: the< 
others. However./ the.x register should, be-preservediwhen either "«pt 
UP I/O PORTS" or "SETST0CK POINTER" are-de leted. 

3. The; constants and the-VIC register tab le :; <VTBL;' are given 

sample values arid > user 1 * ' 

program. 


roL 
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